Applicants Response to Examiner's Comments 

Examiner's Response to Declaration under CFR 1.131 

Examiner objects to the Declaration under CFR 1.131 as filed on January 22, 2007 as 
failing to present evidence sufficient to the conception of the invention by demonstrative evidence. 

Applicant respectfully submits that the enclosed Exhibits A through H evidence that the 
method of the present invention was conceived and reduced to practice without reference to prior 
art, and that Applicant produced working models of present invention prior to calendar year 
2002. 

To support Applicant's attestation that the method of the present invention was reduced 
to practice prior to the filing date of USPTO Patent Application 20030154197, Millet et al. of 
August 14, 2003, Applicant includes herein the following eight Exhibits A-Gthat were produced 

■ 

at the time during the initial implementation phases of the invention: 

A. ExtraView Objects Definition, authored no later than April 27, 2001; 

B. ExtraViewJSchema_3 .1.2.1 .doc, authored no later than September 1 5, 200 1 ; 

C. ExtraView Administrator's Guide Version 3.1.2.1, authored no later than July 
24,2001; 

4 

D. Problem_UDF.java, a Java software code for generating SQL for accessing a 
UDF, authored no later than December 30, 2002; 

E. Report.java, containing a a Java software code for generating SQL for 
accessing a UDF, authored no later than December 19, 2002; 

F. ExtraView.pdf (diagram of ExtraView database schema), authored no later 
than March 11,2002; 

G. Internal electronic correspondence regarding SQL generation for UDF access, 
with a subject heading of "mo betta SQL statement", emailed on October 10, 

2002; and 

H. Internal electronic correspondence regarding SQL generation for UDF access, 
a with subject heading of "From eternity to 1 6 seconds", emailed on May 8, 

2002. 
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Applicant further attests to the following timeline of development and application of the 
present invention: * 

> 1999-2000: implementation and delivery of PL/SQL version of ExtraView, , 
including user-defined fields (UDF's); 

> 2000-2001 : re-engineering of the PL/SQL into Java code for the first 
version of ExtraView (Java) in December, 2001 ; 

> 2001-2002: completion and enhancement of the UDF capabilities in subsequent 
ExtraView versions; and 

> 2007:- version 5.2 of ExtraView. 

More specifically, a UDF implementation according to the method of the present 
invention comprises the following aspects: 

1 . A database schema that allows users to add unlimited numbers of UDF's to be added to 
problem records. 

2. Software logic to manage the UDF's, including creation, deletion, and modification of 
UDF attributes. 

3. Graphical user interface using a Web browser, for accessing the functionality of UDF's; 
for example, administration of UDF's and retrieval or definition of UDF values for UDF 
instances in problem records. 

4. Reporting functionality to provide searching/filtering by UDF and rendering of UDF ' 
values and titles to output devices such as web browser, Excel spreadsheets, or text 
documents 

Applicant maintains that a lack of any of these crucial aspects of the method of the 
present invention would render application of the UDF concept much less valuable: 

Applicant respectfully submits that the exhibits provided herein indicate how to use the 
UDF's evolved in accordance with the method of the present invention as claimed in Applicant's 
ExtraView product prior to 2002. 

The software and these documents were used by real customers in companies to solve 
business problems with UDF's in the ExtraView product. This is prima facie evidence that an 
implementation existed and included the four specific aspects that are crucial to the invention. 
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EXHIBIT A: Internal UDF Software Object Definition 

The following is taken from the enclosed Exhibit A, a written document entitled 
"ExtraView Objects Definition", dated April 27, 2001. Applicant notes that many of the data 
structures necessary to implement the claims of the invention are described therein: Attention is 
respectfully drawn to page 3 wherein the following statement was made. 


(Beginning of insertion of page 3 of Exhibit A.) 

• Titled Object: an abstract base class 

o ID • 

10 o Name 

o Title 

o Sort sequence (within TitledObjects with same ID) 

• User-Defined Field (aka UDF): is a Titled Object & has: 

o Data Type (Text Field, Text Area, Log Area, Number, 

15 Date, List, or URL) 

o Flags: 

■ required/ optional , 

■ di splay-as -url /display-normal, 

■ select -on-reports /no- select -on-reports 
20 o Help Text 

o Help URL 

o UDF Values (1:0.. n relationship to UDF Value)* 

• UDF -Value has: 

o Problem Id 

25 o UDF Id 

o Value 

o Value Number 

o Value Date 

o UDF List Membership (1:1 relationship to UDF List) 
30 • UDF List : has 

o Title 

o Owning User 

o (1:0.. n relationship to UDF) 
35 (End of insertion of page 3 of Exhibit A.) 
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EXHIBIT F: Schema for UDF Tables 

Also included as Exhibit F is a rendition of the schema used for the 4.0. 1 release of an 
ExtraView.TM software. The Exhibit F document is dated March 1 1 2002, but it clearly 
documents the schema that was used earlier for the version released in December, 200 1 . The 
particular tables of importance to UDF's are: 
UDF (Page 5); 
PROBLEMUDF (Page 5); 
UDF_LIST (Page 5); 
PROBLEMTEXT (Page 5); and 
PROBLEMUDFHIST (Page 2) 
More particularly: 

> The UDF is the primary dictionary table for looking up UDF characteristics, such 
as title, etc.; 

> PROBLEM UDF is where the UDF values are stored, and values may take on 


> 
> 
> 


different data types and therefore there are multiple value columns; 
UDFLIST contains the list values for enumerated UDF's; 
PROBLEM TEXT contains the text for the long text- valued UDF's.; and 
PROBLEM UDF HIST contains history for the UDF values in 
PROBLEM UDF. 


20 EXHIBIT B: Problem UDF 


The following description is copied from pages 59 & 60 enclosed Exhibit B, a written 
document entitled "ExtraView_Schema_3. 1.2.1", dated September 15, 2001. 

(Beginning of insertion of pages 59 & 60 of Exhibit B.) 


PROBLEM UDF 


Intersection data associating issues to User Defined Fields, including text, numeric, or date 
value. 
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Column Name 


Title Format Text 


CREATEDBYUSER 


VARCHAR2(30) 

The user who 

created this 

problem User 

Defined Field. 
• 

DATECREATED 

• 

DATE 

The date when 
this problem 
User Defined 
Field was 
created. 

LAST_DATE_UPDATED 


DATE 

The date when 
this User 
Defined Field 
was last updated. 

LASTUPDATEDBYUSER 


VARCHAR2(30) 

The user that last 

• 

updated this 
problem User 
Defined Field. 

PROBLEMID 

* 


NUMBER 

The identifier of 
the issue to 
which this 
problem User 
Defined Field 
belongs. 

UDFID 

• 


NUMBER 

The identifier of 
the User Defined 
Field to which 
this problem 
User Defined 
Field belongs. 

UDFLISTID 


NUMBER 

The identifier of 
the User Defined ' 
Field list to 
which this 
problem User 
Defined Field 
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belongs. 

VALUE 

• 


VARCHAR2(256) 

The text value 
for this User 
Defined Field for 
an issue. 

VALUE_DATE 


DATE 

The date value 
for this User 
Defined Field for 

• 

an issue. 

VALUENUMBER 

• 


NUMBER 

The numeric 

value for this 

User Defined 

Field for an 
• 

issue. 


(End of insertion of pages 59 & 60 of Exhibit B.) 
EXHIBIT C: Graphical User Interface 

There are two major aspects to the graphical user interface aspects of UDF's: 
administration of UDF's and usage of the UDF in adding or editing problem records. From the 
Exhibit C, a printed document entitled "Extraview Administration Guide Version 3.1.2.1", the 
screen shot (as found on page 15 therein) illustrates a method of adding a new UDF. The 
insertion of this screen shot of page 1 5 of Exhibit C begins on the following page of this 
communication. 
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/lew entry to the User Defined Fields table 

Name 

l 


i 

Title 



I 

Data table name | 



Column name in [able J 



Data Type 

<?■ TEXTFIELD CTEXTAREA CLOGAREA C NUMBER ODATE C LIST CTAB CURL 

Requiied field 

0 

Yes 

G No 

Display as URL 

O 

Yes 

G No 

url| 



. Aliow selection on sports 

0 

Yes 

6 No 

Allow new entries to be added dyarnicaliy to list 

0 

Yes 

6 No 

Help text 



HI 

Hefp URL 



S 

i 

... . . i 



• 



1 

ipdate 

1 teiSII 


(End of insertion of page 15 of Exhibit C.) 
5 Exhibit C discloses that once a UDF is created, the UDF is treated like any other field 

that can be added to a problem record through a layout editing administrative function. Then the 
screen for adding/editing might look something like the following screen shot (taken from a 
problem report in the ExtraView support site). Many of these fields are UDF's, including the 
"Description", "Comments", and "Resolution". An important aspect is that the user cannot 
10 differentiate between a UDF and a native, inbuilt field. 
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(Beginning of insertion of screen shot.) 


^5 Cdit: 10005 - Microsoft Internet Explorer 



:resa 


spby&p from option-Display&p id=1 0005 ^G6 f i!in&Vg} Support ^ Awtih$^ Win Update ' > ; : : / ■ ■ if . - -. ,r- ; ■ ;^f^^M 


Problem Summary Edit 








m ■ 


Problem #10005 


Created Nov 14, 2001 








■ ■ ■: 

- ; - - 



. ..■■ '•>:■ '•■ r y :■ 



Title Ijhkjhjkh 
Product | qqq S] 

Category (Hardware I] 

Module ppfl || 

Version Open 
|*None*l] 


Status | unassigned 
Priority [p"j || 

Severity ]l ow 


Last Modified Nov 14, 2001 2:19:05 PM 


Originator Carl Koppel 


Owner | carl Koppel i 
Assigned To | Carl Koppel j£j 


Version Closed Resolution 
|*None*gj |*None* 


t^dd:ano^erjyerston^;| 


Description 
OQ 


Comments 
QQ 


jhkjhjkhjkhjkh 


Attachments 


Remove this blank row 


Generate Email P CC Email [ 

Mailing List 


^^^^^^^^^^ 


f^pjatejv : . Delete j Intoest^^-' j History ! Clone Return 


.Ml 


I'- 


ll 


I 

■„-...- 

; U 



(End of insertion of screen shot.) 
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EXHIBIT C: UDF Reporting 

The Exhibits disclose that UDF values can be shown on reports with their associated 
titles. Reports can be generated for email and/or immediate HTML browsing, for example. The 
screen shot below, excerpted from page 79 of Exhibit C , shows an email report with values of 
5 several UDF's shown, e.g., "Platform", "OS" and "Clarify ID". 

(Beginning of insertion of page 23 of Exhibit C.) 

Subject: DEV - 12231 
Date: Fii, 15 Jun 2001 16:53:09 -0700 (PDT) 
From: "ExfraView"<exfraview. qa@sesame. com> 
To: "Robbie Lloyd" <rHoyd@sesame. com> 




T <«« • 1 1 


- - ; 

WE - • ■ 


■ I Edit 1 I 




:: - 





12231 • 

test 

P.'O'JUCt' 

»>.<net 'b;F:.:|?|p^^ 

Created 

Lan Modified . . . 


NetOp 

udele malabanan 

08-MAR-2001 

15-JUN-200 i 16:61 


WlSlttyyiy.::,.:.,..::.,..;;.:;, . . . 

Assigned To 


Alt ID 

Changed By , ' 

• 

Hardware 

rob lloyd 

Private 


RQB.LLO"YD 

Severity 

Prioistw 

<.::;:;:!!Nii[ 

i: : 



:;. ,...: r 




:■:■: ■ 

. " . 



rn2 




Module 

'. ?$$f^?. 










■ ■■ ■ . ■'.'//.■' : ^ ^v> - ' -= V'S**~: V?' * ' 

»>■>•<?■•: > •■■ 

; '•:■•-?•>■. 

PM 






Platforms 



Cuftorrier 


800 TDM 




Test Case JD < 

:i.;^&'^=^:^W5^l : . 

Test Case Location 



I'-;""-" " ; V, 

; :,.:;;-.(:.> ; .;>; ^v:.<.:.::..:v.p^::;-,;:.f::| : t.^ 






Version Gpers 

StJt'JS 

Version Closed" 












1 

Ciosed 






test 

Comments 






hil: ^:'::H 



R«»e*s« Notes • 






:::;. : ::.f.-^'^ 







Encloses -/l;:::.: 



er 











cc: Michelle Medina , rob lioyd . Robbie Lloyd . • 
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(End of insertion of page 23 of Exhibit C.) 
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"IX ITEM UDF1") ) ; 


EXHIBIT E: Report Logic 

Access to UDFs for reports imposed an extra join on the problem_udf table. The Java 
code for generating SQL for accessing a UDF was as follows (from pages 63-65, Exhibit E, the 
4.0 version of the document entitled "Report.java" module). 

(Beginning of insertion of pages 63-65 of Exhibit E.) 

//★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★a********** 

// * CREATING THE UDF JOINS 
// 

fromTable . setLength (0) ; 

if ( "UDF" . equal slgnoreCase (re . getDdeType () ) ) { 

tableAlias = re . getDdeName ( ) ; //"UDF" + String. valueOf (udf Cnt++) ; 

//This was for before we used views 

// 

//tableAlias = "IU_" + ddeName; 
//tableListAlias = "UL_" + ddeName; 
//tableUdf Alias = "U_" + ddeName; 

distinctTables .put (tableAlias , thisDDE) ; 

udflndexHint . append ( " " + Z . dbms . indexHintString( tableAlias , 

sortOrderlnf o . setTableAlias (tableAlias) ; 
//sortOrderlnfo. setTableListAlias (tableListAlias) ; 
sor tOrder Inf o . setSor tOrder Field ( sof ) ; 
sortOrderlnfo . se tSor tBy ( tableAlias + " . VALUE " ) ; 
sortOrderlnfo . setSortByRawVal ( tableAlias + " . VALUE " ) ; 

fromTable . append ( " (select distinct "+re . ge t I TEM_UDF ( ) +" . item_id \ "ITEM_ID\" , 
") ; // need this for the bad_^Lata problem 

if (this.hr) { 

fromTable . append ( re . ge tl TEM_UDF ()+"." +ge tHi s tKey ( re . ge 1 1 TEM_UDF ( ) , true ) + 

M II _|_ 

getHistKey (re.getlTEMO ,true)+", ") ; 

} 

if ( "LIST" . equal slgnoreCase (re . getDdeDi splay Type ( ) ) 

I | "POPUP" . equal slgnoreCase (re . getDdeDi splay Type ( ) ) 
I | "TAB" . equal slgnoreCase (re . ge tDdeDi splay Type () ) ) { 

fromTable . append ( " udf_list. title TITLE, udf_list .udf_list_id VALUE, 
udf_list.sort_seq SORT_SEQ " + 

" from udf , udf_list, "+re.getITEM_UDF() + 

" where udf.udf_id = "+re.getITEM_UDF() + " .udf_id "+ 

" and udf_list.udf_list_id = "+re . getITEM_UDF () +" .udf_list_id " + 

" and udf .name = ? ) ") ; 

sortOrderlnfo . setSortBy ( tableAlias + " . TITLE " ) ; 
sortOrderlnfo. setSortByRawVal (tableAlias + ".VALUE"); 

} 

else if ( "DATE" .equal slgnoreCase (re . getDdeDi splay Type ( ) ) ) { 

fromTable . append ( re . getITEM_UDF ( ) + " . value_date VALUE " + 
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" from udf , "+re . getITEM_UDF ( ) + 

" where udf . udf_id = "+re.getITEM_UDF()+" .udf_id " + 
" and udf . name - ? ) " ) ; 

} 

else if ( "NUMBER" . equals I gnoreCase (re . getDdeDi splay Type ( ) ) ) { 

f romTable . append ( re . get I TEM_UDF ( ) + " . value_number VALUE " + 
" from udf, "+re . getITEM_UDF () + 

" where udf . udf _id - "+re.getITEM_UDF () +" .udf_id " + 
" and udf . name -?)"); 

) 

else if ( "USER" . equal slgnoreCase (re . getDdeDi splayType ( ) ) ) { 

sortOrderlnf o . setSortBy ( this . getFormattedNameForQuery ( tableAlias , 
"security_user__id" , 
"first_name" , 
"last_name") ) ; 

f romTable . append ( 

re.getITEM_UDF()+ ".value VALUE, « + 

"su.first_name FIRST_NAME , su.last_name LAST_HAME, " + 

" su . security_user_id SECURITY_USER_ID " + 

11 from security_user su, udf, "+re.getITEM_UDF()+ 

" where udf .udf_id = "+re.getITEM_UDF() +" .udf_id " + 

" and su . security_user_id = " + re.getITEM_UDF() + ".value "+ 

" and udf .name = ? ) ") ; 

> 

else{ 

f romTable. append ( re . getITEM_UDF ( ) + " .value VALUE " + 
" from udf, "+re . getITEM_UDF ( ) + 

" where udf.udf_id = "+re . getITEM_UDF ( ) +" .udf_id " + 
11 and udf .name = ? ) ") ; 

} 

paramsSortOrder . add (re . getDdeName ( ) ) ; 
types Sor tOr der . add ( " STRING" ) ; 

// join in the UDF from table 

// " " 

fromCnt++; 

jd.addAll (f romTable . toStringO , 
tableAlias , 
jd.LEFT_JOIN, 
DRIVER_KEY , 
re . getDriverAlias ( ) , 
DRIVE R__KE Y , 

l) ; 


if (this.hr) { 

andSortOrder . append ( " and 11 +tableAlias+ " . " + 
getHistKey (tableAlias , true) + 

Z .dbms . ojequals () + driverTable +"."+ 

getHistKey (driverTable , false) ) ; 

) 

soFields . put (String . valueOf ( sof . getOrderRank ( ) ) , sortOrderlnf o) ; 


* 

This software code as documented in Exhibit E generates SQL similar to this example 
(for enumerated UDF values): 


select * from item, 
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(select distinct i tem_udf . i tem__id ITEM_ID, udf_list . title TITLE , udf_list .udf_list_id 
VALUE, udf_list . sort_seq SORT_SEQ 

from udf , udf_list, item_udf 
where udf . udf _id = item_udf . udf_id 
and udf list, udf list id = item udf .udf list id 
and udf .name = 'fred 1 ) udfView 
where item. item id = udfView.item id; 


(End of insertion of pages 63-65 of Exhibit E.) 
The novel and inventive aspect of method of the present invention documented by Exhibit E is 
that the UDF values require additional, creative SQL generation that implements the access of 
the data structures described in the schema. 
EXHIBIT D: Edit Retrieval of UDF Values 

For the editing of an existing problem record, the existing UDF values must be retrieved 
for display in the EDIT screen. This is done by generating SQL and executing the SQL as 

* 

documented in the software codes of Exhibit D, the document entitled "Problem_UDF.java" of 
December 19, 2002. 

(Beginning of insertion of pages 7-9 of Exhibit D.) 

* <p> Sets udf text values in hashmap. This is only used by presentation. 

* It sets 2 items in the HashMap. The first item is the 'TEXT' value in the t>roblem_text 

table 

* for udf_id assoicated with this problem id. The second is the value from the 

* problem_udf table that is associated with this problem id. This is either the 

* value, value_date , value_number or udf_list__id depending on udf _type . </p> 

* @ par am String problemld 

* @param Connection dbconn 

* @ par am HashMap hash 
*/ 

public static void setHash(SesameSession session, Connection dbconn, String problemld, 
HashMap hash, 

boolean includeLogAreas ) 
throws Exception { 

String udf Type = null; 
String prevUdfld = null; 
String udf Id = null; 
String udfName = null; 

String text = null; 

StringBuf f er udf Text = new StringBuf f er ( ) ; 

if (! includeLogAreas) { 

udf Text . append ( " select pt . udf_id, id_seq , text_seq, text , u . name " ) ; 

udf Text . append ( " from udf u, data_dictionary dd, problem_text pt ") ; 

udf Text . append ( " where pt . problem_id = ? " ) ; 

udf Text . append ( " and u . udf _id = pt . udf _id " ) ; 

udf Text .append ( " and dd.name = u.name ") ; 

udf Text . append ( " and dd.display_type <> 1 LOGAREA' ") ; 

udf Text . append ( " order by 1 , 2 , 3 " ) ; 


} else { 
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udf Text . append ( " select pt.udf_id, id_seq, text_seq, text, u.name from problem_text 
pt, udf u where problem_id = ? ") ; 

udf Text . append ( " aftid u.udf_id = pt.udf_id ") ; 
udf Text . append ( " order by 1, 2 , 3 " ) ; 

5 } 

StringBuffer udfVal = new StringBuf f er ( " select pu.UDF_ID, VALUE, VALUE_NUMBER , 
VALUE_DATE , pu . UDF_LIST_ID , TITLE , u . name " ) ; 

udfVal . append ( " from udf list ul, problem udf pu, udf u ") ; 
10 udfVal . append ( " where problem id = ? " ) ; 

udfVal . append { " and ul . udf _li s t_id " + Z . dbms . oj equals ( ) + " pu . udf _li s t_id" ) ; 
udfVal . append ( " and pu . udf _id = u . udf _id 11 ) ; 
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PreparedStatement statement = dbconn . prepare Statement (udf Text . toString ( ) ) ; 

statement . setString (1 , problemld) ; 
try{ 

// get long text udf s 

ResultSet result = statement . executeQuery () ; 


StringBuffer sb = null; 
while ( result .next () ) { 

udfld = result. ge tS tring ( "UDF_ID" ) ; 
udfName = result. gets tring ("NAME") ; 
25 if (result. getlnt ("TEXT_SEQ") > 1) { 

sb . se tLength ( sb . length ( ) - Z . TEXT_OVERLAP ) ; 
sb . append (result . gets tring ( "TEXT" ) ) ; 
} else { 

sb = new S tr ingBuf f er ( re sul t . ge tS tring ( " TEXT " ) ) ; 

30 > 

hash . put (udfNajne , sb . toString ( ) ) ; 

> 

} catch (Exception e) { 
35 ErrorWriter . write (e , Err orWr iter . LOG) ; 

> finally { 

statement . close ( ) ; 

> 

40 PreparedStatement statement2 = dbconn. prepare Statement (udfVal . toString ()) ; 

statement2 . setString (1 , problemld) ; 
// get rest of udfs 
try { 

45 ResultSet result2 = statement2 . executeQuery () ; 

while (re sul t2 . next ( ) ) ( 

udfld = result2.getString("UDF_ID") ; 
udfName = resul t2 . getString ( "NAME " ) ; 
50 udf Type = Z . dictionary . getDisplayType (dbconn , udfName) ; 

String value = null; 

// get the value from the correct column, depending on the udf type 
if (DataDictionary .isListType (udf Type) ) { 
55 value = resul t2. getString ("UDF LIST ID") ; 


) else if (udfType. equals ("DATE")) { 

Times tamp dateVal = re sul 1 2 . ge tTime s tamp ( " VALUE_DATE " ) ; 
Calendar date = Convert . toCalendar (da teVal) ; 

DbTime dbt = new DbTime (session, dbconn) ; 


if (date != null) { 

dbt. setDbNow (date) ; 
65 value = dbt . getShortDate ( ) ; ; 

> 
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} else if (udf Type, equals ("NUMBER")) { 

value = resul t2 . get String ( " VALUE_NUMBER " ) ; 

) else { 

value = resul t2 . gets tring ( "VALUE " ) ; 


> 


if (hash. get (udfName) != null) { // for multi -valued udfs, add to the array 
String [] udf list = null; 

if (hash . get (udfName) instanceof String[]) ( 

String [] currlist = (StringU) hash. get (udfName) ; 


udf list = new String [currlist. length + 1] ; 
for (int i = 0; i < currlist . length; i++) { 
udflist[i] = currlist[i]; 

> 

udf list [currlist .length] = value; 


} else { 


udf list = new String [2] ; 

udflist[0] = (String) hash. get (udfName) ; 

udf list [1] = value; 


hash . put (udfName , udf list) ; 


} else { // not multi -valued, just put in hashmap 
hash. put (udfName, value) ; 

if ("DATE". equals (udf Type)) { 

hash. put ( (udfName + "JSVDISPLAY") , value); 

} else { 

hash. put ( (udfName + "_EVDISPLAY") , result2 . gets tring ( "TITLE") ) ; 

> 


) 


) 

} catch (Exception e) { 

ErrorWriter . write (e , ErrorWriter . LOG) ; 
) finally { 

statement2 . close ( )•; 

) 

> 


(End of insertion of pages 7-9 of Exhibit D.) 
The novel and inventive aspect of the method of the present invention embodied by this 
code sequence of Exhibit D is that the retrieval of the values and display titles for the UDF 
requires creative SQL generation and retrieval of data in an efficient manner. 
EXHIBIT H: Implementation Progress 

20 Ser.Ho. 10/767,511 


Exhibit H comprises an email of May 8 , 2002 having a subject header of "from here to 


eternity in 16 seconds", wherein some of the background work of the implementation of the 
method of the present inventign is commented upon by the author of the email. 

(Beginning of Exhibit H, "from eternity to 16 seconds".) 

From: Rick Banister [rick@sesame.com] 
Sent: Wednesday, May 08, 2002 4:32 PM 

To: Tom Strzemieczny ; Maria Scharin; Carl Koppel; Michael Stebbins; 

Steve Hoydic 

Cc : dev@ sesame . com 

Subject: From eternity to 16 seconds 

I've got the worse case query so far down to 14 second, which is to query on 5 problem fields, 1 
udf , and sort by a UDF. The EXPLAIN PLAN shows rediculously high cost, but the actual performance 
is very good, even with the SGA cache cleared by restarting the database. 

There are two items, a DDL change to bring the values into the index for an index-only search, 
and changing the query to use FIRST_ROWS so it doesn't try a full index query of the PROBLEM_UDF 
table: 

DROP INDEX IX_PROBLEM_UDFl ; 
CREATE INDEX IX_PROBLEM_UDFl 

ON PROBLEM_UDF (problem_id, udf_id, VALUE, VALUE_NUMBER , VALUE_D ATE , UDF_LIST_ID 

) 

TABLESPACE EXTRAVIEW_IDX ; 
ANALYZE INDEX IX_PROBLEM_UDFl ESTIMATE STATISTICS SAMPLE 20 PERCENT; ANALYZE table PROBLEM__UDF 
ESTIMATE STATISTICS SAMPLE 20 PERCENT; 

select /*+ ORDERED firs throws 

INDEX (PROBLEM1 IX_PR0BLEM5) 

INDEX (PROBLEM2 IX_PROBLEM6) 

INDEX (PROBLEM3 IX_PROBLEM7) # 

INDEX ( PROBLEM4 IX_PROBLEM8 ) 

INDEX (PROBLEM5 IX_PROBLEM2) 

index (pudf ix_problem_udf 1) 
*/ PROBLEM1 . ID 

from PROBLEM PROBLEM1, PROBLEM PROBLEM2 , PROBLEM PROBLEM3 , PROBLEM 

PROBLEM4 , PROBLEM PROBLEMS, problem_udf pudf, udf_list where PROBLEM1 . PRIORITY in ('PRIORITY 
2') and PROBLEM2 . SEVERITY_LEVEL in ('MAJOR') and PROBLEM3 . STATUS in ('OPEN') and 
PROBLEM 4 . PRODUCT_NAME in ('EVJAVA') and PROBLEMS .ASS I GNED_TO in ( ' AIMEN ' ) and PROBLEM2 . ID = 
PROBLEMl . ID and PROBLEM3 . ID = PROBLEM2 . ID and PROBLEM4 . ID = PROBLEM3 . ID and PROBLEMS . ID = 
PROBLEM4 . ID and pudf . problem_id ( + ) = problems . id and nvl (pudf . udf_id ( + ) , 8 8 ) = 88 and 
udf_list .udf_list_id(+) = pudf .udf_list_id and exists 

(select 1 , 

from problem_udf udf 1 

where udf 1 .problem_id = PROBLEMS . id 

and udfl.udf_id =88 

and udfl.udf_list_id = 6231) 
ORDER BY udf _list. title DESC 

(End of Exhibit H, "from eternity to 16 seconds".) 
EXHIBIT G: Implementation Progress 

In another evidence of implementation progress, Exhibit G comprises an email of 
October 10, 2002 having a subject header of "mo betta SQL statement", wherein more of the 
background work of the implementation of the method of the present invention is commented 
upon by the author of this email. 
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(Beginning of Exhibit G, "mo betta SQL statement".) 


From: robert lange [rlange@sesame.com] 
Sent: Thursday, October 10, 2002 11:59 AM 
To: Dev@ Sesame. Com 
Cc: LeeAnn Pultz; Maria Scharin 
Subject: mo betta SQL statement 

I ran into some surprising results tuning a query that I want to pass on to anyone writing SQL — 
at least for the Oracle platform. The change involved replacing two joins in the where clause 
with "pseudo tables" in the where clause. The first change decreased resources by a factor of 
10,000 in the explain plan, but the resulting query still took 37 What was especially surprising 
is that in the final change, even though the explain plan didn't show significant difference, the 
execution speed changed dramatically: by a factor of 40 again. 

the basic query involved reporting, where you have a list of ids, and the problem udf table, the 
first pass on the query looked like this (simplified for clarity) : 

select p. id, p2.id 

from problem p, problem p2, problem_udf pu, udf u where p. id in (?,?,?,?,?,?,?,?) and pu.udf_id = 
u . udf _id and u . name = ' ? ' 

and p2.id in (select problem_id from problem_udf 

where udf id = u.udf iS and u. value = p. id) ; 


the key was to rewrite the code to put some of the where clause into the from clause, step 1 
was : 

select p. id, p2.id 

from (select id from problem where id in (?,?,?,?,?,?,?,?)) p, 

problem p2, problem_udf pu, udf u 
where p. id in (?,?,?,?,?,?,?,?) 
and pu . udf _id = u . udf _id and u.name = ' ? ' 
and p2.id in (select problem_id from problem_udf 

where udf_id = u.udf_id and u. value = p. id) ; 

this reduced resources per the explain plan by a factor of 10,000 or so, but the query still took 
40 seconds to run for 5 ids. the second step was to apply the same strategy to eliminate the 
joins on the udf table: 

select p. id, p2.id 

from ( select id from problem where id in (?,?,?,?,?,?,?,?)) p, 
problem p2, 

(select problem_id, value from udf, problem_udf 

where udf .name = ? and problem_udf . udf _id = udf .udf_id) pu where pu. value = p. id and p2 . id 
= pu . problem_id ; 

this version did not look different in the explain plan, but the execution time dropped to under 
a second. 

I'm not sure that this is always more efficient, and it may have to do with the fact that the 
actual query was quite a bit raore complex, but the approach clealy can have dramatic results. 

enjoy, 

robert 

(End of Exhibit G, "mo betta SQL statement".) 
Conclusion 

Applicant respectfully submits that it is clear from the referenced documents that the 
design and implementation of the method of the present invention as claimed was 
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completed2002. Indeed, the initial UDF implementations occurred in late 2000 and early 2001. 
Applicant therefore respectfully submits that date of invention of the method of the present 
invention predates the cited and related art disclosed in Millet et al., and that Claims 1-9 as 
currently amended are therefore allowable. 

Examiner's 'Objections to Informalities of Amendment A 

Examiner objects to Amendment A as filed on January 22, 2007 for the informality of line 
numbers representing specific line numbers of the printed page running together with the amended 
Claims. Applicant replies that the Claims as amended herein do not present line numbers running 
together with Claim numbers. 

Specification Amendment A 

Examiner objects to the amendment of the Specification as submitted on January 22, 2007. 
Applicant acknowledges that the amendment to the Specification as submitted on January 22, 2007 
has not been entered. 

Claim Objections 

Examiner objects to Claim 6 for stating "the plurality of first datafields of each of the 
plurality of UDF's", as each UDF has only one "first datafield". Applicant has deleted the words 
"of each" from Claim 6 as currently amended, and therefore respectfully responds that Claim 6 is 
allowable. 

Examiner objects to Claim 8 for missing the word "of" in front of the phrase "a plurality 
UDF's". Applicant has added the word "of" as suggested by Examiner in Claim 8 as currently 
amended. Applicant therefore respectfully responds that Claim 8 is allowable. 

Claim Rejections - 35 USC § 112 

Examiner rejects Claims 1-10 under 35 U.S.C. 101 as being directed to non-statutory ' 
subject matter. Examiner rejects Claims 1, 5, 6, 8 and 9 for use of the words "may be". 
Applicant has amended Claims 1, 5, 6, 8, and 9 and replaced the words "may be" with the word 

» 

"is" in this communication and therefore respectfully responds that Claims 1, 5, 6, 8 and 9 are 
allowable. 

Examiner rejects Claim 1 for lacking antecedent basis for the limitation of "the record" 
and the limitation "the table". Applicant responds that Claim 1 as currently amended recites "a 
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software record" and "a software table" in the preamble to Claim 1. Applicant respectfully 
submits that Claim 1 as currently amended is allowable. 

Examiner rejects Claim 4 for lacking antecedent basis for the limitation of "the name"*. 

Applicant responds that Claim 4 as currently amended reads "a name", and respectfully submits 
that Claim 4 as currently amended is allowable. 
Applicant cancels Claim 10. 

Claim Rejections - 35 USC §101 

Examiner rejects Claims 1-10 under 35 U.S.C. 101 as being directed to non-statutory 
subject matter. 

Examiner rejects Claims 1-4 and 9 because the term "computer-readable medium" is not 
limited to tangible medium in Paragraph 0102 of the Specification as originally filed, but rather 
includes an acoustic or light wave as a form of "computer-readable medium". Applicant 
responds that Claims 1-9 have been amended to method claims and that the objection to the 
scope of definition of the term "computer-readable medium" as an article of manufacture is 
therefore moot. 

Applicant respectfully therefore submits that the Claims 1 -9 as currently amended satisfy 
the requirements of 35 U.S.C. 101 and are allowable. 

Claim Rejections - 35 USC § 102 

Examiner rejects Claims 1-10 under 35 U.S.C. 102 paragraph (e) as being anticipated by 

* 

a Patent Application by Millet, et al. (Publication 2003/0154197). 

Applicant respectfully directs Examiner's attention to the accompanying Declaration 
under 37 C.F.R. § 1.131, wherein Applicant submits an attestation and supporting documentation 
of Exhibits A through G that Applicant's data of invention is antecedent to that of Millet, et al., 
and that Millet et al. is therefore not Prior Art as required under 35 U.S.C. 102 paragraph (e). 

Examiner rejects claims 1-10 under 35 U.S.C. 102(e) as being anticipated by Millet et al. 
(Publication No US 2003/0154197). 

Examiner rejects claim 1 as being anticipated by Millet et al. , and that Millet et al. teach: 

"A computer-readable medium having stored thereon a computer-readable program code 

comprising a sequence of instructions which, when executed by a computer, cause the computer 
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to perform steps" (as per Abstract and [0040]) comprising: 

"forming a first user-defined data field structure, or first "UDF" (as per Abstract, [0040], 
[0048] and Fig. 13 each of the records in the "Custom Field Values" data table is equivalent to 
Applicant's "UDF"), the first UDF comprising: 
5 M, an record identifier datafield" (as per [0042], [0044], [0048], [0054] and Fig. 13 for 

"Row 10" datafield); "an UDF identifier datafield" (as per [0048] and Fig. 13 for "Field 10" 
datafield); "a first datafield" (as per [0048], Fig. 13 and Fig. 15 wherein "Value" or FieldValue" 
datafield is equivalent to Applicant's "first datafield"); "storing a record identifier in the record 
identifier datafield" (as per Fig. 13); "storing a UDF identifier in the UDF identifier datafield" (as 
10 per Fig. 13); and "storing an additional information in the first datafield, whereby the first 

datafield is associated with the record and the additional information stored in the first datafield 
may be associated with the record and without modification of the table" (as per Abstract, [0048] 
and Fig. 13). 

Applicant replies that the reference of Millet et al. as cited by the Examiner. is not Prior 
15 Art under 35 U.S.C. 102 and that Claim 1 is therefore allowable. 

Examiner rejects claim 2 based on arguments given above for rejected claim 1 
and is also additionally rejecting this claim for the following: 
Examiner holds that Millet et al. teach: 

"forming a metadata, the metadata comprising a classification of data type, the 
20 classification of data type distinguishing the data type of the additional information stored in the 
first datafield; and associating the metadata with the first UDF" (as per [0048], ,"0056] and Fig. 
10 wherein attribute information is equivalent to Applicant's "metadata", the type of data in the 
field is equivalent to Applicant's "classification of data type"; also see [0041] and [0073]). 

Applicant respectfully replies that Claim 2 depends from the independent and allowable 
25 Claim 1, and is therefore allowable. 

Examiner rejects claim 3 based on arguments given above for rejected claim 1 
and is also additionally rejecting this claim for the following: 

Examiner holds that Millet et al. teach: 

"forming a metadata, the metadata associated with the first UDF, and the metadata 
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comprising a name, the name associated with the first UDF and the name for use in software 
operations accessing the first UDF; and 

associated the metadata with the first UDF" (sec Abstract, [0048], [0056] and Fig. 10 wherein 
field attribute information store in "Custom Fields" table is equivalent to Applicant's "metadata 
associated with the first UDF", and field name such as "Memo" is associated with a custom field 
or UDF as illustrated in Applicant's claim language; also see [0073]). 

Applicant respectfully replies that Claim 3 depends from the independent and allowable 
Claim 1, and is therefore allowable. 

* 

Examiner rejects claim 4 based on arguments given above for rejected claim 1 
and is also additionally rejecting this claim for the following: 
Examiner holds that Millet et al. teach: 

"forming a metadata, the metadata comprising a title, the title associated with the first 
UDF and the name for use in a visual display of the additional information of the first 1JDF; and 
associating the metadata with the first UDF (as per [0056] wherein field attribute information in 
"Custom Fields" table is equivalent to Applicant's "metadata associated with the first UDF", and 
"text associated with that field" is equivalent to title as illustrated in Applicant's claim language). 

Applicant respectfully replies that Claim 4 depends from the independent and allowable 
Claim 1, and is therefore allowable. 

Examiner Rejects claim 5 based on arguments given above for rejected claim 1 
and is also additionally rejecting this claim for the following: 

. Examiner holds that Millet et al. teach: 
"forming a class plurality of UDF's and wherein the first datafield comprises a class 
identifier of the class plurality of UDF's" (as per [0048], Fig. 12 and Fig.15 wherein set of 
custom fields associated with each database table within the RDBMS is equivalent to Applicant's 
"a class plurality of UDF's", and "TablelD" or "ValuelD" is equivalent to Applicant's "class 
identifier") , and each UDF of the class plurality includes: 

"the class identifier" (as per Fig. 10-12 wherein "TablelD" is equivalent to Applicant's 

claim language); 

"a unique identifier of the UDF of the class plurality ofUDF's" (as per Fig. 1 0 wherein 
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"FieldID" is equivalent to Applicant's claim language); and 

M a datafield, whereby each datafield of the class plurality of UDF's may be associated 

* 

with the first UDF and therefrom associated with the record, and information may be 
stored in the plurality of data fields of the class plurality of UDF's and associated with the 
first UDF's, and therefrom the information of the plurality of data fields of the class 
plurality of UDF's may be associated with the record and without modification of the 
table (as per Fig. 1 0, arid Fig 1 3 wherein records of table in Fig. 1 0 is equivalent to 
Applicant's "the class plurality of UDF's", each record of table in Fig. 13 is equivalent to 
Applicant's "first UDF", the "FieldID" in both table indicates the association between two 
table or the association between the class plurality of UDF's and the first UDF as in 
Applicant's claim language, the "RowlD" in table of Fig. 13 indicates the associate 
between that table and the database table. 

Examiner maintains that Millet et al. teaches the association between UDF and class 
plurality of UDF's with records in the database table as illustrated in Applicant's claim language; 
also see [0057]). 

* 

Applicant respectfully replies that Claim 5 depends from the independent and allowable 
Claim 1, and is therefore allowable. 

Examiner rejects claim 6 based on arguments given above for rejected claim 1 
and is also additionally rejecting this claim for the following: 

Examiner holds that fillet et al. teach: 

"forming a plurality of UDF's" (as per Fig. 15 and [0057] wherein "Custom Field Values" 
table is equivalent to Applicant's "data structure" and its records is equivalent to 
Applicant's "a plurality of UDF's"); 

"storing an identifier of the first UDF In the record identifier datafield of each of the 
plurality of UDf ' (as per Fig. 15 wherein "FieldID" is equivalent to Applicant's claim 
language); 

"storing a unique identifier in the record identifier datafield of each of the plurality of 
UDF's" (as per Fig. 5 wherein "ValuelD" is equivalent to Applicant's claim language); 
and 

■ 
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"storing information ig each of the first datafields of each of the plurality of UDF's. 

Examiner asserts that the plurality of first datafields of each of the plurality of UDF's are 
associated with the first UDF and information may be stored in the plurality of datafields and 
associated with the first UDF and therefrom the information of the plurality of datafields may be 
5 associated with the record and without modification of the table M (as per Fig. 5 and [0057]- 
[0058] wherein "RecordID" is equivalent to "datafield" as illustrated in Applicant's claim 
language since "RecordID" is a primary /foreign key which allows connecting record to another 
record which includes plurality of datafields; also see [0046]). 

Applicant respectfully replies that Claim 6 depends from the independent and allowable 
1 0 Claim 1 , and is therefore allowable. 

■ 

Examiner rejects claim 7 based on arguments given above for rejected claim 1 
and is also additionally rejecting this claim for the following: 
Examiner holds that Millet et al. teach: 

"to store a pointer in tfce record identifier datafield for use as the record identifier" (as per 
15 Fig. 13, [0048] and [0054] wherein "RowID" is equivalent to Applicant's "a pointer" and "the 
record identifier" because it points to location of the record in the table). 

Applicant respectfully replies that Claim 7 depends from the independent and allowable 
Claim 1 , and is therefore allowable. 

Examiner Rejects claim 8 based on arguments given above for rejected claim 1 and is 
20 also additionally rejecting this claim for the following: 

Millet et al. teach: 

"forming a plurality ofUDF's, .each UDF associated with a same record stored in a table" 
(Fig. 15 and [0057] wherein "Custom Field Values" table is equivalent to Applicant's "data 

■ 

structure" and its records is equivalent to Applicant's "a plurality of UDF's"), "whereby the 
25 plurality of first datafields are associated with the same record and 

information may be stored in the plurality of datafields and associated with the first UDF and 
therefrom the information of the plurality of datafields may be associated with the same record 
and without modification of the table" (as per Fig. 5 and [0057]-[0058] wherein "ValuelD" is 
equivalent to "datafield" as illustrated in Applicant's claim language since "ValuelD" is a 
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primary /foreign key which allows connecting record to another record which includes plurality 
of datafields; also see [0046]). 

Applicant respectfully replies that Claim 8 depends from the independent and allowable 
Claim 1, and is therefore allowable. 

Examiner rejects claim 9 based on arguments given above for rejected claim 1 
and is also additionally rejecting this claim for the following: 

Examiner holds that Millet et ah teach: 
"forming a data structure having a record, a list and a list user-defined field, or List 
"UDF", the List UDF relatable to the record" (as per [0041], [0048] and Fig. 15 wherein a table 
is a list of records, and any custom field associated with the table is equivalent to Applicant's 
"list user-defined field"), and the List UDF comprising: "an identifier of the List UDF" (as per 
Fig. 10 wherein "FieldID" is equivalent to Applicant's claim language): "an identifier of the List" 
(as per Fig. 10 wherein "TablelD" is equivalent to Applicant's "claim language"); and "a data 
address of the List, whereby an information stored at the data address of the list is associated 
with the List UDF and the information may be stored or modified at the data address of the list 
and the information may be associated with the record and without modification of the table" (as 
per [0073] and [0074] wherein the second values table as disclosed is equivalent to the List and 
the disclosure of retrieval of information from the table implies the inclusion of some data 
address to access table from its storage). 

Applicant respectfully replies that Claim 9 depends from the independent and allowable 
Claim 1, and is therefore allowable. 

Examiner rejects claim 10 as being anticipated by Millet et al. teach: 

"A computer system" (as per Abstract) comprising: 

"a controller" (as per [0040]); "a memory, the memory communicatively coupled with the 
controller and the memory storing a software database and a software database manager" (as per 
[0040] for database and database application); "a software database having data organized into a 
table of records" (as per [0041]); "a user-defined field stored in the memory for associating a 
datum with a record of the table, the user defined field having a UDF identifier and a record 
identifier" (as per [0040], [0048], [0073] and Fig. 13 and 15 wherein "FieldID" is e.quivalent to 
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Applicant's "UDF identifier", and "RowID" or "RecordID" is equivalent to Applicant's "record 
identifier"); • 

"a metadata stored in the memory and associated with the user-defined field and the 
metadata specifying the data type of the datum" (as per [0056] and Fig. 10 wherein field attribute 
5 information is equivalent to metadata as illustrated in Applicant's claim language); and 

"the database manager software program for directing the controller to merge the user- 
defined field with the record to associate the datum of the user-defined field with the record of 
the table" (as per [0040] and [0061] wherein the application allowing user to add data column as 
necessary as disclosed is equivalent to Applicant's "database manager software program"). 
10 Applicant replies that Claim 10 is cancelled, while reserving the right to submit 

Claim 10 in a Continuation Application, and that Examiner's arguments are therefore moot. 

In summation, Applicant respectfully submits that the Examiner's objections to the 
Claims have been fully resolved by the Claims 1 -9 as currently amended. Applicant further 
respectfully submits that the Examiner's rejections of the Claims have been fully traversed by 
15 scope and recitations of the Ctaims 1-9 as currently amended, and that the Claims 1-9 are 
therefore allowable. 

If any matters can be resolved by telephone, Applicant requests that the Patent and 
Trademark Office call the Applicant at the telephone number listed below. 
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Patrick Reilly 
Patent Attorney 
Box 7218 

Santa Cruz, CA 95061-7218 
30 (831) 332-7127 
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Report . java 
package com.extraview.applogic. report; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


java. sql 
java. io. * ; 
java. uti 1 . * ; 

com. extraview. applogic. * ; 

com . ex t r avi ew . appl ogi c . admi n . * ; 

com . ext ravi ew . appl ogi c . 1 ayout . * ; 

com . ext ravi ew. appl ogi c . securi ty . Securi tyliser ; 

com. extraview. usercustom. * ; 

com . ext ravi ew . presentati on . Di spl ay ; 

com . ext ravi ew. presentati on . chart . * ; 

com . ext ravi ew . u t i 1 . * ; 

com . ext ravi ew . common . * ; 

com . ext ravi ew . dbms . * ; 

com . stevesof t . pat . * ; 

com . sesame . 1 og . Log ; 

com. sesame. misc. Errorwriter; 

com . ext ravi ew . appl ogi c . securi ty . Secu ri tyPe rmi ssi on ; 


s 


public class Report extends Titledobject implements Transactional, cacheable, 
SeriaTizable, Sequenced { 

// Transactional 


pri 
pri 
pri 
pri 


// 


Audi 
pri 
pri 


vate boolean modifiedData = false; 
vate boolean newData = false; 
vate boolean deletedData = false; 
vate transient Connection conn = null; 


vate String createdBy = null; 
vate String updatedBy = null; 
private java. sql .Timestamp createdon = null; 
private java. sql .Timestamp updatedon = null; 


// Local 
private 
private 
private 
private 
private 
private 
private 
private 
private 


bool 
bool 
bool 
bool 
bool 
bool 
bool 


ean 
ean 
ean 
ean 
ean 
ean 
ean 
ean 


sSummaryReport = 
sStatusOnDate = 
sProductOnDate = 
sRel easeOnDate = 
sStatusByDate = 
sProductByDate = 
sReleaseByDate = 
isChart = false; 


bool 

int timelnterval = 4; 


= false; 
false; 
: false; 
■ false; 
false; 
= false; 
= false; 


private boolean hr = false; 

private boolean hasCalculatedFields = false; 

private boolean isCaselnsensitive = false; 

private boolean unlimitedResults = false; 

private int reportld = 0; 

private int fi I terGroupld = 0; 

private int layoutld =0; 

private int sortorderld =0; 

private int reportGroupld = 0; 

private int chartld = 0; 

private string outputTypeName = null; 

private string reportTypeName = null; 

private String securi tyGroupld = null; 

private String securi tyUserld = null; 

private String driverTable = "ITEM"; 
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Report. java 
private String reportListURL = null; 

// Reporting objects 

private FilterGroup fg = null; 
private Reportchart reportchart = null; 
private Layout 1 = null; 
private SortOrder so = null; 

private ArrayList calculatedFields = new Arrayl_ist(); 
private string concatHint = z.dbms.concatHintO + " "; 
private string concatHi ntstri ng = Z.dbms. concatHi ntStringO ; 
private HashMap suppressedMul ti ReleaseFi Iters = new HasnMapO; // redback 
thing- they only want to see the child releases they filter on in the report results 

// 


Constants 

private static final int MAX_PERSIST_LIST_SIZE = 5000; /// this MUST BE A 

MUTIPLE OF 20 -- the INTERNAL PAGE SIZE; 

private static final String _TEXT = "&%TEXT"; 

final String _TI ME STAMP = "&%timestamp" ; 
final Strinq _USER = "&%USER" 


private static 

private static 

private static 

private static 

private static 

private static 

private static 

private static 


fi nal stri 
final stri 
fi nal Stri 
final Stri 


it ii 


ng 

final String q = "\"" ; 

ng sufxO = 
ng sufxl = 
ng sufx2 = "_2"; 
ng sufx3 = "_3"; 
ng tag Prefix = "";//". 


.TAG_ 


"ID" 


// this is the alias 

"PROBLEM_RELEASE_ID"; // this is 


final stri 

private static final string tagsuffix = "";//" 
public static final String PROBLEM_KEY_ALlAS = 
included in every select query for problem_id 

public static final string RELEASE_KEY_ALIAS = 
the alias included in every select query for problem_release_id 

public static final String PROBLEM_KEY = ITEM_ID" ; // this is the key included 
in every select query for problem_id 

public static final string RELEASE_KEY = "PROBLEM_RELEASE_lD" ; // this is the 
key included in every select query for problem_release_id 
public static final String DRIVER_KEY = "ITEM_ID"; 

private string emptystri ngSpacer = "&nbsp; M ; 

// Used when querying - internal block stuff/ paging / pageblock 

private boolean isNewPersist = false; // determines if you start fresh 
getList() or append to last pageblock 

private boolean startedPageBlockCalc = false; // flag used for setting the 
starting counter for the internal blocks within a pageblock 

private boolean searchAttach = false; // whether to search Blob attachments 
private int maxRows =0; // the maximum number of rows allowed for an umlimited 
search for non BYPASS users 

private boolean filterchildvalue = false; // used for redback originally to 
only show releases they filter on 

private boolean checkMaxRows = false; 
private final int lNTERNAL_BLOCK_SIZE = 20; 
retrieved/processed in memory at a time 

private final int PAGES_PER_PAGEBLOCK = 10; 
hyperl inked at the bottom of the page 

private ValidationList resultBlock = null; 
private Enumeration resultEnum = null; 


// the number of records to be 
// the number of pages to be 


pgs 


nt resultcount = 0; 
nt total Attachmentsize = 0; 
nt unlimi tedBlock = 0; 
nt elementstartAt 
private int pageBlock = 0; 
= block 1) 
private ArrayList pageKeys = null; 
private ArrayList blockKeys = new ArrayListQ; 


private 
private 
private 
private 


= 0; 

// the number of the block of 10 pages (ie 1st 10 
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Report. java 

private int resul tPerPage = 0; 

private int internalBlockStartElement = 0; // the element to start proccessing 
on for the next internal block 

private HashMap dataAlias = new HashMapO; 

private HashMap multi Lookups = null; // used to track records with multiple 
lookup values 

private HashMap prsorts = new HashMapO; //tracks the Sorts that have been added 
for child release records 

private HashMap prFilters = new HashMapO; //tracks the Filters that have been 
added for child release records 

// Regex stuff 

private string esc = "(?e=~)"; 

// Don't put regex 1 es in here: they are not serial izable. 
* ReportO 


* Constructor used to instantiante an new Report object to populate. 

* Gets initial ID from sequence. 

* To get an already existing object use getReferenceO 

k k ^ 

public ReportO throws Exception { 
super() ; 
newData = true; 
setOutputType("BROWSER") ; 

* Report (St ring reportld) 

* @param reportld 

* This constructor is called from get reference it is used given an 

existing ID 

* — note that newData is not set 

public Report(i nt reportld) { 
super(); 

this. reportld = reportld; 
setOutputType("BROWSER") ; 

Jkk 

* getSequence 

* <p>Ensures we return a number if we don't already have one. 

* ©return String - an id number 

V 

public String getsequence() { 
if (this. reportld < 1) { 
try { 

this. reportld = 
Integer . parselnt (Sequence. getNewSeguenceId("REPORT_SEQ")) ; 

} catch (Exception e) { 
; // pass 

} 

} 

return Stri ng . val ueof (thi s . reportld) ; 

} 

public boolean isSummaryReport () { return this.isSummaryReport; } 
public boolean isStatusOnDate(){ return this.isStatusOnDate; } 
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public boolean isProductOnDate(){ return this.i 

public boolean isReleaseOnDate(){ return this.i 

public boolean isStatusByDate(){ return this.i 

public boolean isProductByDate(){ return this.i 

public boolean isReleaseByDate(){ return thi s . i sRel easeByDate ; / 

public boolean ischart(){ return this.ischart; } 


sProductonDate; } 
sReleaseOnDate; } 
sStatusByDate; } 
sProductByDate; ; 


public int getTimelnterval (){ return thi s . timelnterval ; } 

public void setSummaryReport (boolean b){ 
this.isSummaryReport = b; 

} 

public void setstatusOnDate (boolean b){ 
this.isStatusOnDate = b; 
this.setlschart(b) ; 

public void setProductOnDate(boolean b){ 
this.i sProductonDate = b; 
thi s . setlschart (b) ; 

public void setReleaseOnDate (boolean b){ 
this.i sReleaseOnDate = b; 
thi s . setlschart (b) ; 

} 

public void setStatusByDate(boolean b){ 
this.i sStatusByDate = b; 
this. setlschart (b) ; 

public void setProductByDate(boolean b){ 
this.i sProductByDate = b; 
this.setlsChart(b) ; 

} 

public void setReleaseByDate(boolean b){ 
thi s.isRel easeByDate = b; 
this.setlsChart(b) ; 

public void setTimelnterval (i nt interval ){ 
this. timelnterval = interval; 

public void setlschart (boolean b){ 
this.ischart = b; 

private void cleanFlags(){ 

thi s . setSummaryReport (f al se) ; 
thi s . setStatusOnDate(f al se) ; 
thi s . setstatusByDate(f al se) ; 
thi s . setProductOnDate(f al se) 
thi s . setProductByDate(f al se) 
thi s . setRel easeOnDate (f al se) 
this . setRel easeOnDate(false) 
this. setlschart (false) ; 

* populateobj 

*/ 

public void popul ateobj (Map data) {} 

/** 

* addSortOrder 

* @param SortOrder 

** j 

Page 4 


Report. java 
public void addSortOrder(SortOrder sort) { 
this. so = (Sortorder) sort.clone() ; 
this. modi fiedData = true; 

* addLayout 

* ©param Layout 

public void addLayout (Layout layout) { 
this.l = layout; 
this. modi fiedData = true; 

* getLayout 

* ©returns Layout 

public Layout getLayout () { 
return this . 1 ; 

} 

* addFilterGroup 

* ©param FilterGroup 

public void addFi 1 terGroup(Fi 1 terGroup filterGroup) { 
this.fg = (FilterGroup) filterGroup. clone() ; 
this. modi fiedData = true; 

} 

* getFil terGroup 

* ©returns FilterGroup 

public FilterGroup getFi 1 terGroupO { 
return this.fg; 

* getReportld 

* ©returns filterGroupld 

** / 

public int getReportld() { 
return this. reportld; 


* getLayoutld 

* ©return layoutld 

public int getLayoutld() { 
return this. layoutld; 

* setLayoutld 

* ©param layoutld 

public void setLayoutId(int layoutld) { 
this. layoutld = layoutld; 
modi fiedData = true; 

} 
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/** 

* getResul tCount 

* ©return Resultcount 

public int getResul tCount() { 
return this. resultcount; 

} 

* getsortorderld 

* ©return sortorderld 

public int getSortOrderld() { 
return this. sortorderld; 

} 

* setsortorderld 

* ©param sortorderld 

public void setSortOrderld(i nt sortorderld) { 
this. sortorderld = sortorderld; 
modifiedData = true; 

} 

* getsortorderld 

* ©return sortorderld 

public Sortorder getSortOrder() { 
return this. so; 

} 

* getFilterGroupld 

* ©return fil terGroupld 

* * I 

public int getFi 1 terGroupld() { 
return this. fil terGroupld; 


* setFilterGroupld 

* ©param fil terGroupld 

public void setFi 1 terGroupId(i nt fil terGroupld) { 
this. fil terGroupld = fi 1 terGroupld; 
modifiedData = true; 

} 

* getOutputTypeName 

* ©return outputTypeName 

public String getOutputType() { 
return this .outputTypeName; 


* setOutputType 

* ©param outputTypeName 

** / 
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public void setOutputType(Stri ng outputTypeName) { 
this. outputTypeName = outputTypeName; 

if ("BROWSER .equal slgnoreCase(outputTypeName)) emptystri ngSpacer = 
"&nbsp;"; 

else if ("TEXT" . equal slgnoreCase(outputTypeName)) emptystri ngSpacer = ""; 
else if ("MS_EXCEL". equal slgnoreCase(outputTypeName)) emptystri ngSpacer = 

else if ("MS_WORD". equal slgnoreCase(outputTypeName)) emptystri ngSpacer = 
"&nbsp;"; 

* isHTMLOutputType 

* @param outputTypeName 

kk / 

public boolean isHTMLOutputType () { 

i f ("BROWSER" . eaual slqnoreCase(outputTypeName) 

"MS_WORD . equal slgnoreCase(outputTypeName) 
"MS_EXCEL" . equal slgnoreCase(outputTypeName)) { 
return true; 

} else return false; 

public boolean isTextOutputType() { 

return "TEXT" . equal slgnoreCase(thi s . outputTypeName) ; 

* getReportType 

* ©return outputTypeName 

public String getReportType() { 

return (this. reportTypeName == null ? "" : this. reportTypeName) ; 

Jkk 

* setcaselnsensi ti vesearch 

* @param isCaselnsensitive 

kk J 

public void setcaselnsensi tiveSearch( boolean isCaselnsensitive ) { 
this. isCaselnsensitive = isCaselnsensitive; 

} 


Jkk 

* setReportType 

* @param ReportTypeName 

public void setReportType(Stri ng reportTypeName) { 
this . reportTypeName = reportTypeName; 

//Z. probe("RPT: reportTypeName =" +this. reportTypeName ); 
if (this. reportTypeName. indexof ("HISTORY") > -1) { 

this.driverTable = "ITEM_HIST"; 

this.hr = true; 
} else { 

this.driverTable = "ITEM"; 

this.hr = false; 

} 

} 

/kk 
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** / 

public boolean isHistoryReportO { 
return this.hr; 

} 

/** 

public void setSearchAttach(bool ean searchAttachment) { 
this.searchAttach = searchAttachment; 

} 

/** 

public boolean getSearchAttach() { 
return this.searchAttach; 

} 

* 

** / 

public boolean hasCalculatedFields() { 
if (this.calculatedFields.sizeO > 0) 

this. hasCalculatedFi elds = true; 
else this. hasCalculatedFi elds = false; 
return thi s . hascal cul atedFi el ds ; 

} 

/ft ft 

* setResul tPerPage 

* @param int resul tPerPage 

** / 

public void setResul tPerPage(i nt resul tPerPage) { 
this. resul tPerPage = resul tPerPage; 

if (this. resul tPerPage == -1) this.unlimitedResults = true; 


/ft ft 

* getResul tPerPage 

* ©return int 

**/ 

public int getResul tPerPage() { 
return this. resul tPerPage; 


/* * 

* setReportListURL 

* @param ReportListURL 

**/ 

public void setReportLi stURL(Stri ng reportLi stURL) { 
this. reportListURL = reportLi stURL; 
modifiedData = true; 

} 

/* ft 

* getReportListURL 

* ©return reportListURL 

ft* / 

public String getReportListURLO { 
return this. reportListURL; 
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* getCalculatedFields 

* ©return calculated fields 

public ArrayList getCalculatedFields() { 
return this.calculatedFields; 

} 

* getchartld 

* ©return chart id 

public int getchartld() { 
return this.chartld; 

} 

* getReportChart 

* ©return reportchart 

public Reportchart getReportChart() { 
return thi s . reportchart ; 

} 

* getPresentationChart 

* ©return chart 

y 

public Chart getPresentationchartO { 
return thi s . reportchart .getChartQ ; 


* setLastUpdatedByliser 

* ©param userld 

public void setLastUpdatedByliser (Stri ng userld) { 
this. updatedBy = userld; 
modifiedData = true; 


* getSecuri tyUserld 

* ©return securi tyUserld 

•kk J 

public Strinq getSecuri tyUserldC) { 
return this.securityUserld; 

* setsecuri tyUserld 

* ©param securi tyUserld 

k-k I 

public void setsecuri tyuserld(stri ng securi tyUserld) { 
this.securityUserld = securi tyUserld; 
modifiedData = true; 

} 


/k-k 

* getSecuri tyGroupld 
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* ©return securi tyGroupld 

public String getsecuri tyGroupld() { 
return this. securi tyGroupld; 


Jkk 

* setSecuri tyGroupld 

* @param securi tyGroupld 

public void setsecuri tyGroupid(string securi tyGroupld) { 
this. securi tyGroupld = securi tyGroupld; 
modifiedData = true; 

} 

public void setName(Stri ng value) { 
this. name = value; 
modifiedData = true; 


* 

public void setTitle(string value) { 
this. title = value; 
modifiedData = true; 


* setFi 1 te rchi 1 dval ue 

* @param boolean filterchildvale 

V 

public void setFilterChildValue(boolean fil terchild){ 
this.filterchildvalue = filterChild; 


* getReference( Connection conn, int reportld ) 

* ©param conn 

* ©param reportld 

* ©return Report 

* ©throws invalidReportException 

* creates a static reference of Report for a given reportld 

-k-k J 

public static Report getReference(Connection conn, int reportld) throws 
InvalidReportException, Exception { 
Report r = null ; 

// check if we have a connection 

if (conn == null) throw new Exception("Null connection"); 

if (reportld == 0) throw new lnvalidReportException("Report Id is null");. 

string query = "select REPORT_lD, " + 

LAYOUT_ID, "+ 
SORT_ORDER_ID, " + 
FILTER_GROUP_ID, " + 
OUTPUT_TYPE_NAME , " + 
REPORT_TYPE_NAME, " + 
REPORT_GROUP_ID, " + 
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TITLE, " + 
DESCRIPTION, 


it 


SECURITY_GROUP_ID, + 
SECURITY_USER_ID, " + 
DATE_CREATED, " + 
LAST_DATE_UPDATED, " + 
LAST_UPDATED_BY_USER, " + 
CREATED_BY_USER , " + 
TITLE_MAP_KEY , " + 
REPORT_LINK_URL " + 

from report 11 + 
where report_id = ? " ; 


string cf Query = 


ii 


select CALCULATED_FIELD_ID, 
REPORTED, " + 
NAME, " + 
CALCULATION, " + 
ORDER_RANK " + 
from CALCULATED_FIELD 

where report_id = ? 
order by order_rank 


PreparedStatement statement = null; 
Preparedstatement cf Statement = null; 


ii 


M 


II 


try { 


id: 


ii 


statement = conn . prepareStatement (query) ; 

statement . setlnt (1, reportld) ; 

ResultSet result = statement. executeQueryO ; 

// Get the information associated with this report_id 

// 

if (result. next()) { 

r = new Report(reportld) ; 

r. reportld = result. getlnt("REPORT_lD") ; 

r.layoutld = result. qetlnt("LAYOUT_ID") ; 

r.sortorderld = result .getlnt("SORT_ORDER_ID M ) ; 

r.filterGroupid = result .getlnt("FILTER_GROUP_ID") ; 

r .outputTypeName = result .getstri ng("OUTPUT_TYPE_NAME") ; 

r . setReportType(resul t . getstri ng ("REPORT_TYPE_NAME")) ; 

r . reportGroupld = resul t . getlnt ("REPORT_group__ID") ; 

r.name = resul t. getstri ng ("TITLE") ; 

r. title = resul t.getst ring ("DESCRIPTION") ; 

r . titleMapKey = resul t.qetLong ("TITLE_MAP_KEY") ; 

r.securityuserld = result .getstri ng("SECURITY_USER_ID") ; 

r .securityGroupld = resul t.getst ring ("SECURITY_GROUP_lD") ; 

r.createdon = resul t.getTi mestamp("DATE_CREATED") ; 

r.updatedon = resul t.getTi mestamp("LAST_DATE_UPDATED") ; 

r.updatedBy = resul t.getString("LAST_UPDATED_BY_USER") ; 

r.createdBy = resul t. getstri ng("CREATED_BY_USER") ; 

r. reportListURL = result .getstri ng("REPORT_LlNK_URL") ; 

else { 

throw new lnvalidReportException("Could not get reference for report 
+ reportld); 

// Get the Calculated Fields 

// 

cfstatement = conn. prepareStatement(cfQuery) ; 

cf Statement. setlnt (1, reportld) ; 

ResultSet cf Result = cfstatement . executeQueryO ; 
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while (cfResul t . next()) { 
calculatedField cf = new 
Cal cul atedFiel d (cfResul t . getlnt ( M CALCULATED_FIELD_ID M ) ) ; 

cf .setReportld(cfResult.getlnt("REPORT_ID")) ; 

cf . setDDName (cfResul t . getst ri ng ("NAME")) ; 

cf . setcal cul ati on (cfResul t . getst ri ng ("CALCULATION") ) ; 

cf . setOrderRank(cf Resul t . getlnt ("ORDER_RANK")) ; 

cf .setDisplayName(cf .getDDName() , cf .getCalculationO , conn); 

r . cal cul atedFi el ds . add (cf ) ; 

} 

// Get a reference of the objects that make a report 

// 

if (r.sortorderld != 0) r.so = SortOrder .getReference(conn, 
r.sortorderld) ; 

r.fg = FilterGroup.qetReference(conn, r.filterGroupId) ; 

if (r.layoutld != 0) r.l = Layout ,getReference(conn, 
St ri ng . val ueOf (r . 1 ayoutld) ) ; 

catch (Exception e) { 

Z. log. writeToLog(Log. ERROR, "Error in method getReference: " + e) ; 
throw e; 

finally { 

//close statements 

if (statement != null) statement. close() ; 

if (cfstatement != null) cfStatement.close() ; 

return r; 

} 

* getReference( Connection conn, String userld, string title, String 
reportType, String outputType ) 

* @param conn 
Oparam title 
@param reportType 
@param outputType 

* ©return Report 

* ©throws InvalidReportException 


* creates a static reference of Report for a given title 

public static Report getReference(Connection conn, String userld, string name, 
String reportType, string outputType) throws InvalidReportException, Exception { 
Report r = nul 1 ; 

// check if we have a connection 

if (conn == null) throw new Exception("Null connection"); 

string query = "select REPORT_ID, " + 

LAYOUT_ID, " + 
SORT_ORDER_ID , " + 
FILTER_GROUP_ID , " + 
OUTPUT_TYPE_NAME , " + 
REPORT_TYPE_NAME, " + 
REPORT_GROUP_ID, " + 
TITLE, " + 
DESCRIPTION, " + 
SECURITY_GROUP_ID, " + 
SECURITY_USER_ID, " + 
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DATE_CREATED, " + 
LAST_DATE_U PDATED , 
LAST_UPDATED_BY_USER , 
CREATED_BY_USER, " + 
TITLE_MAP_KEY, " + 
REPORT_LINK_URL " + 

from report " + 

where SECURITY_USER_ID 

and TITLE = ?" + 

and R E PO RT_T Y P E_N AM E 
and OUT P UT_T Y P E_N AM E 

order by REP0RT_ID "; 


tt 


= ? 


ti 


ii 


? + 
?" + 


string cf Query = 


select cf . CALCULATED_FIELD_ID , " - 
Cf .REPORTED, " + 
cf . NAME , " + 
Cf .CALCULATION " + 
from CALCULATED_FIELD cf , REPORT 

where cf.report_id = r.report_id 

and r.SECURITY_USER_ID = 

and r. TITLE = ?" 

and r.REPORT_TYPE_NAME = 
and r.OUTPUT_TYPE_NAME = 

order by cf .order_rank " ; 


r 
ii 


• i 


+ 
? 

■ 

? 


ii 


n 


• i 


+ 
+ 


PreparedStatement statement = null; 
PreparedStatement cf Statement = null; 


try { 


statement = conn. preparestatement (query) ; 
int i = 1; 

statement . setst ri ng (i ++ , userld) ; 
statement. setstring(i++, name); 
statement . setst ri ng (i ++ , reportType) ; 
statement . setstri ng(i++, outputType) ; 
Resultset result = statement. executeQueryO ; 

// Get the information associated with this report_id 

// 

if (result. next()) { 

int reportld = result .getlnt("REPORT_lD") ; 

r = new Report(reportld) ; 
r.layoutld = result. getlnt ("LAYOUTJD") ; 
r.sortorderld = result . getlnt( ,, SORT_ORDER_ID tt ) ; 
r.filterGroupld = resul t . getlnt ("FILTER_GR0UP_ID") ; 
r.outputTypeName = resul t.getst ring ("OUTPUT_TYPE_NAME") ; 
r . setReportType (resul t . getstri ng ( M REPORT_TYPE_NAME u )) ; 
r. reportGroupId = resul t.getlnt ( f, REPORT_GROUP_ID M ) ; 
r.name = result .getstri ng ("TITLE") ; 
r. title = result. getstri ng ("DESCRIPTION") ; 
r. titleMapKey = resul t . getLong ("title_map_key") ; 
r.securityuserld = result .getstri ng("SECURlTY_USER_lD") ; 
r.securi tyGroupld = resul t . getstri ng("SECURlTY_GROUP_lD") ; 
r.createdon = resul t.getTi mestamp("DATE_CREATED") ; 
r.updatedon = resul t.getTi mestamp( M LAST_DATE_UPDATED") ; 
r.updatedBy = resul t. getstri ng("LAST_UPDATED_BY_USER") ; 
r.createdBy = resul t. getstri ng("CREATED_BY_USER") ; 
r. reportListURL = result .getstri ng("REPORT_LlNK_URL") ; 


} 

else { 
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throw new lnvalidReportException("Could not get reference for 
user/title/reportType/outputType " + 

userld + "/" + name + "/" + reportType + "/" + outputType) ; 

} 

// Get the Calculated Fields 

// 

cfstatement = conn. prepareStatement(cfQuery) ; 
i = 1; 

ng(i++, userld) ; 
ng(i++, name); 
ng(i++, reportType) ; 
cfstatement. setstri ng(i++» outputType) ; 
ResultSet cf Result = cfstatement. executeQueryQ ; 


cfstatement . setstri 
cfstatement . setstri 
cfstatement . setstri 


while (cfResul t . next()) { 
CalculatedField cf = new 
Cal cul atedFi el d(cf Resul t . getlnt ("CALCULATED_FIELD_ID")) ; 

cf .setReportld(cfResult.getlnt("REPORT_ID")) ; 

cf .setDDName (cfResul t.getstring ("NAME")) ; 

cf . setcal cul ati on (cfResul t . getst ri ng ("calculation") ) ; 

cf . setorder Rank (cfResul t . getlnt ("ORDER_RANK")) ; 

cf .setDisplayName(cf .getDDName() , cf .getCalculation() , conn) ; 

r . cal cul atedFi el ds . add (cf ) ; 

} 

// Get a reference of the objects that make a report 

if (r.sortorderld != 0) r.so = Sortorder ,getReference(conn, 
r .sortorderld) ; 

r.fg = FilterGroup.getReference(conn, r.filterGroupld) ; 

if (r.layoutld != 0; r.l = Layout .getReference(conn, 
St ri ng . val ueof (r . 1 ayoutld)) ; 

catch (Exception e) { 
throw e; 

} 

finally { 

//close statements 

if (statement != null) statement. close() ; 

if (cfstatement != null) cfstatement. close () ; 

return r; 

} 

/** 

* public static void del eteRemovedDDE() 

* @param string ddeName 

* @param Connection conn 

* deletes the dde from sort_order, sort_order_field f filter and filter_criteria 
tables 

V 

public static void deleteRemovedDDE(string ddeName, Connection conn) throws 
Exception { 

Preparedstatement fcstmt = null; 
Preparedstatement cfstmt = null; 
Preparedstatement fstmt = null; 
Preparedstatement sofstmt = null; 
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Preparedstatement sostmt = null; 

String fcQuery = "delete from filter_criteria where filter_id in " + 

" (select filtered from filter where dd_name = ?) "; 

string fQuery = "delete from filter where dd_name = ? " ; 

string cfQuery = "delete from calculated_field where name = ? "; 

String sofQuery = "delete from sort_order_field where sort_order_id in " + 

" (select sort_order__id from sort_order where dd_name = ?) 

try { 

fcStmt = conn. prepareStatement(fcQuery) ; 
fstmt = conn . prepareStatement(fQuery) ; 
sofstmt = conn. preparestatement (sofQuery) ; 
cfstmt = conn. preparestatement (cfQuery) ; 
cfstmt. setstring(l, ddeName) ; 
fcstmt.setstring(l, ddeName); 
fstmt. setstring(l, ddeName); 
sofstmt.setstnng(l, ddeName) ; 
cfstmt. executeupdate() ; 
f cstmt . executeUpdateQ ; 
fstmt . executelipdateO ; 
sofstmt . executelipdateO ; 

catch (Exception e) { 

Z.log.writeTol_og(Z. log. ERROR, "One of these failed:"); 
Z . 1 og . wri teToLog (z . 1 og . ERROR , f cQue ry) ; 
Z . 1 og . wri teToLog (z . 1 og . ERROR , f Que ry) ; 
Z. 1 og. wri teToLog (Z. log. ERROR, sofQuery) ; 
throw e; 

} 

finally { 

if (cfstmt != null) f cstmt . close() ; 
if (f cstmt != null) f cstmt. close() ; 
if (fstmt != null) fStmt.close() ; 

if (sofstmt != null) sofstmt .close () ; 
if (sostmt != null) soStmt.close() ; 

} 


executeTransaction( string user_id ) 

* @param. user_id 

* ©throws java. lang. exception 


* Transactional interface. Executes any pending database changes 


* UNOTEM - Requires that a connection be set with a call to 

* setConnectionO prior to usage. 

** I 

-pQ qq. save calculated 

fi elds !!!!!!!!!!!!!!!!!!!!!!! ! 

public void executeTransaction(Stri ng userld) throws Exception { 

String xsortorderld = null; 
String xLayoutld = null; 
String query = null; 
Preparedstatement statement = null; 
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Stri ng bv = nul 1 ; 

String SYS DATE = Z.dbms.CURRENT_DATE() ; 

// make sure there is a transaction to execute 

if ( ! modi f i edData && ! newData && ! deletedData) return; 

// no database record exists, so do nothing 


if (deletedData && newData) { 
newData = false; 
modi fi edData = false; 
deletedData = false; 
return; 

} 

if (conn — null) throw new Exception("Null connection"); 
try { 

// Delete has priority (since the other flags would be irrelevant) 


if (deletedData) { 

// delete report record 

query = "delete from report where report_id = ? 11 ; 
statement = conn . prepareStatement (query) ; 
statement. setint(l, this. reportld) ; 

//get bindvalues 

bv = PreparedStatementProxy.getBindValues(statement) ; 
if (bv != null) query = query + "<br>(" + bv + ")"; 

z . m . del eteTi tl e (conn , ti 1 1 eMapKey) ; 
statement. executeupdate() ; 
systemLog . logTransaction(conn, 

SystemLogType . DELETE_REPORT, 

query. tost ring ()) ; 
statement .close () ; 

thi s . f g . del ete (conn , userld , f g . getRef erence(conn , 
this.filterGroupld)) ; 

if (this.l != null) this.l .delete(conn, userld, 
String. valueof (this. layoutld)) ; 

if (this. so != null) this.so.delete(conn, userld, this.sortorderld) ; 

} // end delete 

// Insert comes next 

// 

else if (newData) { 

Z.log.writeTol_og(this, Log . DEBUG4, "About to call Insert Report"); 

if (this.l != null) { 

//Z.probe(" THE LAYOUT IS NOT NULL !!!!!!"); 
//Z.probe(" THE LAYOUT ID is > !!!!!!" + 

this.l .getLayoutldO) ; 

this.l .insert(conn, userld) ; 

} 

if (this. so != null) this.so.insert(conn, userld); 
if (this.fg != null) this.fg.insert(conn, userld); 
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query = 


insert into report 
( " + 


ii 


+ 
tt 


ii 


tt 


+ 
+ 


ii 


• i 


ii 


REPORT_ID, + 
LAYOUT_ID, " + 
SORT_ORDER_ID, 
FILTER_GROUP_ID, 
OUTPUT_TYPE_NAME , 
REPORT_TYPE_NAME , 
REPORT_GROUP_ID, 
TITLE, " + 
DESCRIPTION, " + 
SECURITY_GROUP_ID , 
SECURITY_USER_ID, 
DATE_CREATED, " + 
LAST_DATE_UPDATED , + 
LAST_JJPDATED_BY_USER , 
CREATED_BY_USER , " + 
REPORT_LINK_URL, " + 
TITLE_MAP_KEY " + 
) " + 

values ( ?,?,?,? 

" + 

+ SYSDATE + 


it 


it 


//i 

//2 
//3 
//4 
//5 
//6 . 
//7 
//8 
//9 
//10 

//ll 
// SYSDATE 

// SYSDATE 

• //12 

//13 

// 14 


it 


? ? ? ? ? 
-l-f-l-f- 

7 " 


It it 


+ SYSDATE + 


7 7 7 ) 


n 


" 7 

9 ' 


tt 


int newReportld = Integer. parselnt(this . getSequenceO) ; 

// sort order is optional — can be null 
if (this. so != null) xSortOrderld = 
String . val ueof (so.getLatestSortOrderldO) ; 

if (this.l != null) xLayoutld = thi s . 1 . getLayoutldQ ; 


statement 
int index 
statement 
statement 
statement 
statement 
statement 
statement 
statement 
statement 
statement 
statement 
statement 
statement 
statement 
statement 
this, titl 
statement 


= conn 

= 1; 
. setlnt( 
.setstri 
. setstri 
.setlnt( 
. setstri 
.setstri 
. setlnt( 
.setstri 
.setstri 
. setstri 
. setstri 
. setstri 
. setstri 
.setstri 
eMapKey 
.setLong 


preparestatement(query) ; 

index++, newReportld) ; 
ng (i ndex++ , xLayoutld) ; 
ng(index++, xSortOrderld) ; 
i ndex++, thi s . f g . getLatestFi 1 terGroupld()) ; 
ng (i ndex++ , this. out putTypeName) ; 
ng(index++, this. reportTypeName) ; 
index++, this. reportGroupld) ; 
ng (i ndex++ , this. name) ; 

this. title); 
thi s . securi tyGroupId) ; 
thi s . securi tyuserld) ; 
userld) ; 
userld) ; 

ng(index++, this. reportListURL) ; 
= Z.m.getNewTitleKeyO ; 
(i ndex++ , thi s . ti tl eMapKey) ; 


— — - - j 
ng(index++, 
ng(index++, 
ng(i ndex++, 
ng(i ndex++, 
ng(index++, 


userld) ; 


//get bindvalues 

bv = PreparedStatementProxy .getBindValues (statement) ; 
if (bv != null) query = query + "<br>(" + bv + ")"; 

z . m . i nsertTi tl e (conn , thi s . ti 1 1 eMapKey , thi s . 1 ocal e , thi s . ti tl e , 

statement .executeupdate() ; 
Sys temLog . 1 ogTransacti on (conn , 

SystemLogType. ADD_REPORT, 

query . tost ri ng()) ; 
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} // end insert 


// Update when necessary 

else if (modifiedData) { 

if (this. so != null) { 

if (this.sortorderld == 0) this.so.insert(conn, userld); 
else this. so. update(conn, userld, so.getReference(conn, 

this.sortorderld)) ; 

} 

if (this.fg != null) { 

if (this.filterGroupld == 0) this.fg.insert(conn, userld); 
else this.fg.update(conn, userld, fg . getReference(conn, 
this.filterGroupld)) ; 

} 

if (this.l != null) { 

if (this.layoutld == 0) this.l .insert (conn, userld); 

else this.l . update(conn , userld, String. valueOf (this.layoutld)) ; 

} 


query = 


'update report set 1 + 
LAYOUT_ID = ?," + 

SORT_ORDER_ID = ? , " + 
FILTER_GROUP_ID = ? , " + 
OUTPUT_TYPE_NAME = ? , " + 
REPORT_TYPE__NAME = ?," + 
REPORT_GROUP_ID = ? , " + 
TITLE = ?," + 
DESCRIPTION = ?," + 
SECURITY_GROUP_ID = ? , " + 
SECURITY_USER_ID = ? , " + 
L AST_DATE_U PDATED =" + SYSDATE + " B " + 
L AST_U PD AT E D_B Y_U S E R = ?, " + //ll 
REPORT_LINK_JJRL = ?, " + //12 
TITL E_MAP_KE Y = ? " + 

'where report_id = ? " ; //13 


//l 
//2 
//3 
//4 
//5 
//6 
//7 
//8 
//9 
//10 


it it 


// SYSDATE 


statement 

int index 

statement. 

statement. 

statement. 

statement. 

statement. 

statement. 

statement. 

statement. 

statement . 

statement. 

statement. 

statement. 

statement. 

statement. 


= conn. 

= l; 

setlnt( 
setlnt( 
setlnt( 
setstri 
setstri 
setlnt( 
setstri 
setstri 
setstri 
setstri 
setstri 
setstri 
setlnt( 
setLong 


preparestatement(query) ; 

i ndex++ , thi s . 1 ayoutld) ; 
index++, this.sortorderld) ; 
index++, this.filterGroupld) ; 
ng (i ndex++ , thi s . out putTypeName) ; 
ng(index++, this. reportTypeName) ; 
index++, this. reportGroupld) ; 
ng (i ndex++ , thi s . name) ; 

this, title); 
this.securityGroupld) ; 
this.securityUserld) ; 
userld) ; 

thi s . reportLi stURL) ; 
i ndex++ , thi s . reportld) ; 
(i ndex++ , thi s . ti tl eMapKey) ; 


■ ■ ^ v ■ ■ — - ■ ■ y 

ng(index++, 
ng(index++, 
ng(index++, 
ng(i ndex++, 
ng(index++, 


//get bindValues 

bv = PreparedStatementProxy . getBi ndval ues(statement) ; 
if (bv != null) query = query + "<br>(" + bv + ")"; 
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Z.m.updateTi tie (conn, this. titleMapKey, this. locale, this. title, 

userld); 

statement. executeUpdateC) ; 
Sys temLog . 1 ogTransacti on (conn , 

SystemLogType. UPDATE_REPORT, 

query. toStringO) ; 
statement .close() ; 

} //end update 

} 

catch (Exception e) { 

Z. log .wri teToLog (Log. ERROR, "Error in method executeTransaction: " + e) ; 
Errorwri ter . write (e, ErrorWri ter . LOG) ; 
throw e; 

} 

finally { 

if (statement != null) statement. close() ; 

// clear transaction buffers 
newData = false; 
modifiedData = false; 
deletedData = false; 


* getNextResult() 

* ©return HashMap 

* * the returned hashmap of results is one record, keyed by DDNAME 

. V 

public HashMap getNextResul t(SesameSession session) throws Exception { 

String key = ""; 
String elementName = ""; 
String elementType = ""; 
DDEntry thisDDE = null; 

ArrayList leList = null; // list of layout elements 
HashMap row = new HashMapO; 
int counter =0; 

try { 

if (resultEnum == null) 

throw new Exception("The there were no details returned for the 
following block of keys :" 

+ this.blockKeys) ; 
// The enumeration is out of elements so get the next block of page 

results 

// 

while (resultEnum != null 

&& ! resultEnum. hasMoreElements() 

&& (this.elementstartAt + 1) < this . resultcount) { 

resultBlock.clear() ; 

if (this . resultcount == (this.elementstartAt + 1)) { 
thi s . pageKeys . clear() ; 
break; 

} 

getNextlnternal Block(session) ; 
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// Get the row from the enumeration 

if (resultEnum != null && resul tEnum. hasMoreElements()) { 

row = (HashMap) resultBlock.get(resultEnum.nextElement()) ; 
thi s . el ementStartAt++ ; 

} else { 

Z.log.writeToLog (Log. DEBUG, this, "getNextResul t is returning a 

} 


e); 


} 

/ 


} 

catch (Exception e) { 

Z.log.writeToLog (Log. ERROR, this, "Error in method getNextResul t: " + 

ErrorWri ter.write(e, ErrorWri ter . LOG) ; 
throw e; 

} 

finally { 

return row; 

} 


* getNextlnternalBlock() 

* Oparam SesameSession session 

** J 

private void getNextlnternalBlock(SesameSession session) throws Exception { 

int highcnt = 0; 

int retrieveCount = 0; 

resultBlock = new ValidationListO ; 
this.blockKeys.clear() ; 

try { 

// Figure out how many records to iterate in the block 

this.startedPageBlockCalc = true; // just set the starting one once 
until next internal block 

// Deal with unlimited results - process the next unlimi tedResul tBlock 
if (this. unlimi tedResul ts) { 

Persist persist = (Persist) session. getAttribute(session.getld() + 

"_report_j:ds") ; 

int readThisMany =0; 

int currentTopLimit = this.unlimitedBlock * MAX_PERSIST_LIST_SIZE; 

// Z. probe ("@@(a(a(a(a(a this.elementstartAt = "+ this . elementStartAt ); 
// z.probe("@(M@@@@ this. unlimi tedBlock*MAX_PERSlST_LlST_slZE = " + 
this.unlimitedBlock + 1 ' * " +MAX_PERSIST_LIST_SIZE + " = " + currentTopLimit); 

// Z. probe ("@@@@@@(a this, resul tcount = " +this. resul tcount ); 
if (this.elementstartAt < (currentTopLimit) 

&& this.elementstartAt < this. resul tcount) { 

thi s . unlimi tedBlock++; 
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// Here we read from persist startAt to the smallest of: 


iteration 


iteration 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 

// 
// 
// 
// 


a) currentTopLimit 

b) this.maxRows 

c) this. resultcount 

For Example: 

Suppose the maximum that can be read from persist is 

MAX_PERSIST_LIST_SIZE = 5000 
this.maxRows (set from AppDefault) = 7500 
and the result count is 8000 

We will read from 0 to 5000 ids from persist the first 
Then from 5000 to 7,500 (maxRows) 
If maxrows is set to 10,000 then: 

We will read from 0 to 5000 ids from persist the first 


this. resultcount) { 


this.maxRows) 


// Then from 5000 to 8000 (resultcount) 

if (this.elementstartAt + MAX_PERSIST_LIST_SIZE > 

if (this.checkMaxRows) { 

if (this.maxRows > this. resultcount) 
readThisMany = this. resultcount; 

else 

readThisMany = this.maxRows; 

} else { 

readThisMany = this. resultcount; 

} else { 

if (this.checkMaxRows) { 

if (this.elementstartAt + MAX_PERSISTJ_IST_SIZE > 


else 


readThisMany = this.maxRows; 


} 


readThisMany = MAX_PERSIST_LIST_SIZE; 

} else { 

readThisMany = MAX_PERSIST_LIST_SIZE; 


this.internalBlockStartElement = 0; 
// z.probe( M RPT:@@@@@@@@(a(a 
pageKeys . si ze=persi st . read( M +el ementStartAt+" , "+readThi sMany+") : ") ; 

this. pageKeys = persist . read(elementStartAt, readThisMany); 


} 


} 


7/ Z. probe("RPT:@@@@@@@@@@ pageKeys. si ze() : M +pageKeys.size()) ; 
// z.probe("RPT:@@@@@@@@@@ pageKeys : "+pageKeys) ; 
// Z.probe( M RPT:@@@@@@@@@@ 
i nternalBlockStartElement: "+i nternal Bl ockstart Element) ; 

// z. probe("RPT:@@@@@@@@@@ internal_block_size: m +internal_block_size) ; 


if (this. pageKeys. si ze() - (i nternalBlockStartElement + 1) > 

INTERNAL_BLOCK_SIZE) . 

highcnt = INTERNAL_BLOCK_SIZE + i nternal Bl ockstartEl ement ; 

else 

highcnt = pageKeys . si ze() ; 

// z . p r obe ( ; 
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// Z.probeC'RPT:®®®®®®®®®® 

i nternal Bl ockstartEl ement : "+i internal Bl ockstartEl ement) ; 

// Z.probe("RPT:®®®®®®@®®@ highCnt : M +highCnt) ; 

// Create the list to be used for that block 

// 

for (int k = internalBlockStartElement; k < highCnt; k++) { 
thi s . blockKeys . add ((St ri ng) pageKeys . get (k)) ; 
thi s . i nternal Bl ockstartEl ement++; 

} 

//Z. probe ("RPT:@@@@@@@@@@ pageKeys. size () : M +pageKeys.size()) ; 

//Z.probe( M RPT:@@@(a(a@(a@@@ blockKeys: "+bl ockKeys) ; 

//Z . probe (" RPT : @@@@@@@@@@ bl ockKeys . si ze () : "+bl ockKeys . si ze () ) ; 

resultBlock = getSelect(conn, this. blockKeys, session); 

if (resultBlock. isEmptyO) resultEnum = null; 
else resultEnum = resul tBlock. keys() ; 

//z.probe( H RPT:@@@@@@@@(a@ resultEnum: "+resultEnum ); 

catch (Exception e) { 

Z. log. wri teTol_og(Log. ERROR, this, "Error in method getNextBLOCKResul t : " 

+ e); 

Errorwri ter . wri te(e , Errorwri ter . LOG) ; 
throw e; 

} 

} 

public int getResul ts(connection conn, 

boolean isNewPersist p 

int startAt, 

int resul tsOnPage, 

SesameSession session) throws Exception { 

ReportPersist rPersist = null; 
Object temp = nul 1 ; 
string handle = null; 

z.probe("ln Report .getResul ts() ") ; 
try { 

handle = session. getld() + "_REPORT_lDS M ; 

if ((temp = session. getAttribute(handle)) == null) { 

rPersist = new ReportPersist(session) ; 

sessi on . setAtt ri bute (handl e , r Persi st) ; 

this.isNewPersist = true; 

} else rPersist = (ReportPersist) temp; 

return doGetResul ts(conn, isNewPersist, startAt, resul tsOnPage, session, 
rPersist, false); 

} 

catch (Exception e) { 
throw e; 


public int getAttachAlert (Connection conn, 

boolean isNewPersist, 

int startAt, 

int resul tsOnPage, 
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Sesamesession session) throws Exception { 

ReportPersist rPersist = null; 
Object temp = null ; 
String handle = null; 

z.probe("ln Report .getAttachAlertO tf ) ; 
try { 

handle = session. getld() + "_REP0RT_IDS" ; 

if ((temp = session. getAttribute(handle)) == null) { 

rPersist = new ReportPersist(session) ; 

session. setAttribute(handle, rPersist) ; 

this.isNewPersist = true; 

} else rPersist = (ReportPersist) temp; 

return doGetResul ts(conn, isNewPersist, startAt, resultsOnPage, session, 
rPersist, true); 
} 

catch (Exception e) { 
throw e; 

} 


public int getResul ts(Connection conn, 

boolean isNewPersist, 
int startAt, 
int resultsOnPage, 
Sesamesession session, 

String cli PersistHandle) throws Exception { 
CLlPersist cPersist = null; 

try { 

i f (TextManage r . i sSt ri ngvi si bl e (cl i Persi stHandl e) ) { 
cPersist = new CLlPersist(cli PersistHandle) ; 
if (resultsOnPage — -1){ 

sessi on . setAtt ri bute("REPORT_lDS" , cPersi st) ; 

this.isNewPersist = true; 


return doGetResul ts(conn, isNewPersist, startAt, resultsOnPage, session, 
cPersist, false) ; 

} 

catch (Exception e) { 
throw e; 

} 

} 

* doGetResul ts() 

* @param conn 

* @param isNewPersist 

* @param startAt 

* @param resul tsPerPage 

* @param userld 

* gets the results into the class object rs (a result set) 

private int doGetResul ts (Connection conn, 

boolean isNewPersist, 
int startAt, 
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int resul tsOnPage, 
Sesamesession session, 
Persist persist, 

boolean doAttachAlert) throws Exception { 

//z.probeC'In Report .doGetResultsO "); 
boolean doCLl = false 
int lastPageBlock = 0 
int retrieveCount = 0 
int iterations = 0; 
int highCnt = -1; 
Object temp = nul 1 ; 
ArrayList keys = null; 

// Get the list from the DB or Persist save block on n pages in 


// 


try { 

this.isNewPersist = isNewPersist ; 

thi s . setconnection(conn) ; 
if (startAt < 1) startAt = 1; 
this.elementStartAt = startAt - 1; 
thi s . setResul t Per Page ( resul tsOnPage) ; 

// Determine the pageBlock — only read list for that pageBlock 
retrieveCount = thi s . PAGES_PER_PAGEBLOCK * this. result Per Page; 

// New page 

if (paqeKeys != null) this. pageKeys.cl ear () ; 
else tnis.pageKeys = new ArrayListO; 

if (this.isNewPersist) { 

// WE GET 10 pages of keys ONLY... 
//Z.probe("$$$$ NEW PERSIST $$$$"); 
this. pageBlock = 1; 

thi s . getLi st (conn , sessi on , persi st , doAttachAl ert) ; 


} 

else { 


retrieveCount) ; 


//Z.probe("$$$$ EXISTING PERSIST $$$$"); 

//Z . probe (" thi S . PAGES_PER_PAGEBLOCK M +thi S . PAGES_PER_PAGEBLOCK) ; 

//Z.probeC'this. resultPerPage"+this. resul tPerPage) ; 
//Z. probe ("THIS. ELEMENT_START AT = " + this.elementStartAt); 
//z. probe( M retrieveCount = " +retri evecount) ; 
//z.probe("this. pageBlock = " +this . pageBlock ); 

double calcPageCnt = ((double) (this.elementStartAt + 1) / (double) 


//Z. probe("calcPageCnt " + calcPageCnt) ; 


try { 

if (calcPageCnt > this. pageBlock) { 
thi s . pageBl ock++ ; 

getl_ist(conn, session, persist, doAttachAlert); // the next 

pageBlock of keys 

} // no more keys for the current page — go out and get more keys 
catch (lOException ioe) { 
this.pageBlock++; 
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thi s . getLi st (conn , sessi on , persi st , doAttachAl ert) ; 
//Z.probe("RPT: !!!!!!!!! 'KEYS FOR NEXT PAGEBLOCK : M +keys) ; 


//Z.probe("RPT: 
//Z.probe("RPT: 
//Z.probe("RPT: 
//Z.probe("RPT: 
//z.probe("RPT: 


1 1 1 1 1 1 

1 

1 

1 

1 1 1 1 1 1 

1 

1 

1 

1 1 1 1 1 1 

1 

1 

1 

1 1 1 1 1 1 

1 

1 

1 

1 1 1 1 1 1 

1 

1 

1 


to highcnt 

// 


if (persist == null) return 0; 
int size = persist .getDataSize() ; 

if (size == 0) return 0; 

// Figure out how many records to iterate on the screen - from startAT 


this. internal BlockstartElement =0; 
this.unlimitedBlock = 0; 

if (unlimi tedResults) { 
highcnt = size; 
this.unlimitedBlock = 1; 

else { 

highcnt = ((size - elementStartAt) < this. resul tPerPage) ? (si 
elementStartAt) 

a 

this. resul t Per Page; 

this.pageKeys = persist . read(elementStartAt, elementStartAt + 

highcnt) ; 

} 

//z. probe(" "); 

//Z.probe("RPT: !!!!!!!!! ! highcnt:" + highcnt); 

//Z. probe ("RPT: !!!!!!!!! Ithis.internalBlockStartElement^'+this.internalBlockStartEle 
ment) ; 


} 


this.startedPaqeBlockCalc = false; 

if (! doAttachAl ert) getNextlnternal Block(session) ; 


} 


catch (Exception e) { 

Z.log.writeToLog (Log. ERROR, this, "Error in method getResults: " + e) ; 
ErrorWri ter . write (e, ErrorWri ter . LOG) ; 
throw e; 

} 

finally { 

if (doAttachAl ert) return this. total Attachmentsize; 
else return this. resultcount; 


* getCompleteldList() 

* @param Connection conn 
k Oparam int startAt 
k Oparam SesameSession session 
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* returns the complete ID list 

public RelationshipGroupPersist getCompleteldList (Connection conn, 

SesameSession session) throws 

Exception { 

int lastPageBlock = 0; 
int retrieveCount = 0; 
int iterations = 0; 
int highcnt = -1; 
int startAt = 1; 
ArrayList keys = null; 
Object temp = null ; 

RelationshipGroupPersist rgPersist = null; 
try { 

this.isNewPersist = true; 

if ((temp = session. getAttribute("p_prob_array")) — null) { 
rgPersist = new RelationshipGroupPersist(session) ; 
sessi on . setAttri bute("p_prob_ar ray" , rgPersi st) ; 

else rgPersist = (RelationshipGroupPersist) temp; 

// Get the list from the DB or Persist save full list in persist 

// _ 

this . setconnection(conn) ; 
this.elementStartAt = startAt - 1; 
this . setResul t Per Page (-1) ; 

//Z.probe("! !!!!!!!!!!!!!! ! GETTING RELATIONSHIP GROUP COMPLETE ID 
LIST! !!!!!!!!!!!!!!!!!!!"); 

this.getList(conn, session, rgPersist, false); 

} 

catch (Exception e) { 

Z. log. writeToLog(Log . ERROR, this, "Error in method getResults:" + e) ; 
throw e; 

} 

finally { 

sessi on . setAttri bute ("p_prob_ar ray" , rgPersi st) ; 
return rgPersist; 

} } 

* getListO 

* Sparam Connection conn 
@param SesameSession session 
©return ArrayList 

V 

public ArrayList getList(Connection conn, SesameSession session, Persist 
persist, boolean doAttachPersist) throws Exception { 
try { 

this.cleanFlags() ; 

return getMasterList(conn, session, persist, doAttachPersist); 

catch (Exception e) { 

Z.log.wri teToLog (Log. ERROR, this, "Error in method getList:" + e) ; 
throw e; 

, } 
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* getSummaryReportO 

* ©param Connection conn 

* ©param SesameSession session 

* ©return ArrayList 

*/ 

public ArrayList getSummaryReport (Connection conn, SesameSession session) throws 
Exception { 

try { 

thi s. emptystri ngSpacer = 
this.cleanFlagsQ ; 
this.setSummaryReport(true) ; 

return getMasterLi st (conn , session, null, false); 

catch (Exception e) { 

Z. log. writeTol_og(l_og. ERROR, this, "Error in method getList:" + e) ; 
throw e; 

} 

} 

* getStatusOnDate() 

* ©param Connection conn 

* ©param SesameSession session 

* ©return ArrayList 

V 

public ArrayList getStatusOnDate(Connection conn, SesameSession session) throws 
Exception { 

try { 

this . emptystri ngSpacer = "-"; 
this.cleanFlagsQ ; 
this. setSummaryReport (true) ; 
thi s . setstatusonDate(true) ; 

return getMasterList(conn, session, null, false); 

catch (Exception e) { 

Z. log. writeToLog(Log. ERROR, this, "Error in method getList:" + e) ; 
^ throw e; 

* getProductOnDate() 

* ©param Connection conn 

* ©param SesameSession session 

* ©return ArrayList 

V 

public ArrayList getProductonDate(connection conn, SesameSession session) throws 
Exception { 

try { 

this. emptystri ngSpacer = "-"; 

this.cleanFlagsQ; 

thi s . setSummaryReport (true) ; 

thi s . setProductOnDate(true) ; 

return getMasterList(conn, session, null, false); 

catch (Exception e) { 

Z.log.writeToLog (Log. ERROR, this, "Error in method getList:" + e) ; 
throw e; 

} 

} 


* getReleaseOnDate() 
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* @param Connection conn 

* ©param SesameSession session 

* ©return ArrayList 

V 

public ArrayList getReleaseOnDate(Connection conn, SesameSession session) throws 
Exception { 

try { 

this.emptyStringSpacer = "-" ; 
thi s . cl eanFl ags () ; 
this.setSummaryReport(true) ; 
thi s . setRel easeOnDate (t rue) ; 

return getMasterList(conn, session, null, false); 

catch (Exception e) { 

Z.log.writeToLog (Log. ERROR, this, "Error in method getList:" + e) ; 
throw e; 

} 

} 

* getStatusByDate() 

* ©param Connection conn 

* ©param SesameSession session 

* ©return ArrayList 

V 

public ArrayList getStatusByDate(Connection conn, SesameSession session, int 
timelnterval) throws Exception { 
try { 

this.emptyStringSpacer = "-" ; 

thi s.cl eanFl ags () ; 

thi s . setsummary Report (true) ; 

thi s . setstatusByDate(true) ; 

this.setTimelnterval (timelnterval) ; 

return getMasterList(conn, session, null, false); 

catch (Exception e) { 

Z. log. writeToLog(Log . ERROR, this, "Error in method getList:" + e) ; 
throw e; 

} 

} 

* get Product ByDate() 

* ©param Connection conn 

* ©param SesameSession session 

* ©return ArrayList 

V 

public ArrayList getProductByDate(Connection conn, SesameSession session) throws 
Exception { 

try { 

this.emptyStringSpacer = "-"; 
this. cl eanFl ags Q ; 
thi s . setSummaryReport (true) ; 
thi s . setProductByDate(true) ; 

return getMasterList(conn, session, null, false); 

catch (Exception e) { 

Z. log. writeToLog(Log. ERROR, this, "Error in method getList:" + e) ; 
throw e; 

} 


} 
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* getReleaseByDate() 

* @param Connection conn 

* @param SesameSession session 

* ©return ArrayList 

*/ 

public ArrayList getReleaseByDate(Connection conn, SesameSession session) throws 
Exception { 

try { 

this.emptyStringSpacer = "-" ; 
this.cleanFlagsQ ; 
this.setSummaryReport(true) ; 
this.setReleaseByDate(true) ; 

return getMasterList(conn, session, null, false); 
} catch (Exception e) { 

Z.log.writeToLog (Log. ERROR, this, "Error in method getList:" + e) ; 
throw e; 


/**************** ****** *************************************** 
** 

************************************************************************************ 
* 

* getMasterListQ 

* ©return ArrayList of ids/ hashmaps 

* 

* Gets list of IDs for a detailed/ custom / quicklist report 

* OR 

* Does summary report and returns a HashMap of tag/value pairs 

* 

************************************************************************************ 
** 

************************************************************************************ 
** J 

private ArrayList getMasterList(Connection conn, 

SesameSession session, 
Persist persist, 

boolean doAttachAl ert) throws Exception { 


// Used 

// 

boolean 
boolean 
boolean 
boolean 
boolean 
boolean 
boolean 
boolean 
boolean 
boolean 


for processing the query string 

isTimeSeries = false; 
isProductOrReleaseChart = false; 
useNotExists = false; 
appendChartDate = true; 
wildcards = false; 
hasNullCri teria = false; 
skipcomma = false; 
doCalcFields = false; 
gotDate = false; 
addReleaseSql = false; 


nt i = 0; 
nt criteriasize = 
nt fromcnt = 0; 
nt paramCnt = 0; 
nt udfcnt = 0; 
nt sofcnt = 0; 
int joincnt = 0; 


0; 


// count of from tables 
// parameter count 
// udf count 

// sort order field count 
// count of joins made 
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int tableAliasCnt =0; // count of the table aliases 
int retrievecount = 0; 


reports 


Stn 
stri 
stri 
Stri 
Stri 
Stri 
Stri 
stri 
Stri 
Stri 

stri 
Stri 

Stri 
Stri 
Stri 
stri 
Stri 
stri 
Stri 
Stri 


the list table 


Stn 
stri 
stri 
Stri 
stri 
Stri 
Stri 
stri 
Stri 
Stri 
Stri 


it it 


ti ti 


•I n 


ng idCountAlias = "ID_COUNT 
ng valuesufx = "_value"; 
ng alias = 
ng sortBy = 
ng thisTableName = 
ng rawvalue = ""; 
ng processedval ue = 
ng temp = ""; 
ng key = ""; // this is the ddName 
ng keywordHint = z.dbms.indexHint("lTEM 


ii ii 


n 


"IX_ITEM1") ; 


ngBuffer select = new stri ngBuf fer() ; 

ngBuffer gselect = new stri ngBuffer () ; // for the group by/ summary 


"); 


ngBuffer from = new stri ngBuffer (" from "); 
ngBuffer where = new Stri ngBuffer (" where 
ngBuffer groupBy = new Stn ngBuffer (" group by 
ng query = ; 
ng countQuery = ""; 

ng tableAlias = ""; // table alias used in sorting 
ng luTableAlias = ""; // Lookup table alias used in sorting 
ng tableListAlias = "" ; // table alias used in sorting UDF values for 


ng tablelldfAlias = 
ngBuffer andUDF = new Stri ngBuffer () ; 
ngBuffer andKeyword = new Stri ngBuffer () ; 
ngBuffer andProblem = new Stri ngBuffer Q ; 
ngBuffer andother = new Stri ngBuffer () ; 
ngBuffer andSortOrder = new Stri ngBuffer () ; 
ngBuffer andltemType = new Stri ngBuffer () ; 
ngBuffer orderBy = new Stri ngBuffer () ; 
ngBuffer andExists = new Stn ngBuffer () ; 
ngBuffer notExists = new Stri ngBuffer () ; 
ngBuffer precondition = new StringBufferO ; 


Stri ngBuffer cri teriaTableColumn = new St ri ngBuffer () ; 
Object tempObject = null; 

// Other objects used in processing 

// 


ArrayList rawfc = new ArrayListO; // raw filter criteria (no wildcard 
substi ution) 

ArrayList fc = new ArrayListO; // filter criteria 
ArrayList params = new ArrayListO; // the params 
ArrayList paramsUDF = new ArrayListO; // the UDF params 
ArrayList paramsKeyword = new ArrayListO; // the Keyword params 
ArrayList paramsltemType = new ArrayListO; 

ArrayList paramsProblem = new ArrayListO; // the Problem Table params 
ArrayList paramsother = new ArrayListO; // the for storing Table params 
for child tables used in the exist clause 

ArrayList paramsExists = new ArrayListO; // the child Table params 
ArrayList paramsPreCondi tion = new ArrayListO; // the precondition params 
ArrayList typesExists = new ArrayListO; // the types of 

params 

ArrayList paramssortorder = new ArrayListO; // the params for used to 
match the UDF names when sorting on a UDF 

ArrayList types = new ArrayListO; // the types 
ArrayList typesUDF = new ArrayListO; // the UDF types 

ArrayList typesPreCondi tion = new ArrayListO; // the precondition types 
ArrayList typesKeyword = new ArrayListO; // the Keyword types 
ArrayList typesProblem = new ArrayListO; // the Problem Table types 
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ArrayList typesItemType = new ArrayList(); 

ArrayList typesother = new ArrayListO; // the Other Table types 
ArrayList typessortorder = new ArrayListO; // the types for used to match 
the UDF names when sorting on a UDF 

ArrayList results = new ArrayListO; // the resulting list of IDs in the 
result set 

SortOrderlnfo sortorderlnfo = null; 

ArrayList summaryVals = new ArrayListO; 

TreeMap soFields = new TreeMapO; // the sorted list of fields — 

the key is the sort order as a string 

HashMap udfs = new HashMapO; // the referenced HashMap of UDFs 

— this should a reference from a serialized object rather than Database 

HashMap distinctTables = new HashMapO; // used to track distinct tables for 
the "from" & "where" clauses — key is tableName 

HashMap distinctLookupTables = new HashMapO; // used to track distinct 
lookup tables for the "from" & "where" clauses — key is tableName+lookupTableName 

HashMap filter Fields = null; // from data_dictionary where 

filtercriteria = ' Y 1 

HashMap sort Fields = null; // from data_dictionary where sort 

order = 'Y' 

HashMap chartableFields = null; 

HashMap notExistClauses = new HashMapO; 

HashMap existclauses = new HashMapO; 

HashMap existParams = new HashMapO; 

HashMap existTypes = new HashMapO; 

HashMap existAndors = new HashMapO; 

ArrayList nullcri teriaList = new ArrayListO; 
HashMap problemcol umns = new HashMapO; 
HashMap groupByAliases = null; 
HashMap rows = null; 
Timestamp cri teri aTimestamp = null; 
PreparedStatement statement = null; 
PreparedStatement countstatement = null; 
PreparedStatement sumAttachStatement = null; 

Locale loc = session. getLocaleO ; 

DDEntry thisDDE = null; // a Data Dictionary Entry 

DbTime dbt = nul 1 ; 

DbTime dbt2 = null ; 

DbTime dbtForTimeSeries = null; 

Securityuser su = null; 

Filter f = new FilterO; // filter 

DoinData jd = new JoinDataO; 
ReportElement re = null; 

try { 

if (this.isSummaryReportO) groupByAliases = new HashMapO; 

else retrievecount = this. PAGES_PER_PAGEBLOCK * this. resul tPerPage; 


// set values of objects to be used 


su = (Securityuser) session. getAttribute("USER") ; 
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chartableFields = Z. dictionary. getChartableFields() ; 
filterFields = Z. dictionary. getFilterFields() ; 
filterFields. putAll (chartableFields) ; 
sortFields = Z. dictionary. getSortableFields() ; 
sortFi el ds . putAl 1 (chartabl eFi el ds) ; 
udfs = Udf .getUdfMap(conn) ; 

String hashKey = ""; // used to track the exists/ not exists clauses 

HashMap orExists = new HashMapC); // to do an or exists for multi 
criteria when one is a not exists 


// LOOP THROUGH THE FILTERS TO FIGURE OUT THE BETWEEN DATES 

// . 

HashMap origFilters = null; 

if (this.fg != null) origFilters = this.fg.getFiltersO ; 
else origFilters = new HashMapO; 

Z.log.writeToLog(Z.log.DEBUG5/'THE ORIG FILTERS ARE 
this.fg.getFiltersO: " + origFilters); 

Iterator ofi = origFilters. keySet() .iterator() ; 
HashMap betweenDates = new HashMapO; 
HashMap startDates = new HashMapC); 
HashMap filters = new HashMapO; 
String tempDDName = 
Filter tmpf = null ; 
boolean removeFi rstDate = false; 
String stopTimeSeriesDate = 
String startTimeSeriesDate = 


ii it 


» 

n ii 


this .suppressedMul ti ReleaseFi Iters . clear() ; 

if (this.isProductByDateO I I this . isProductOnDateO 

|| this.isReleaseByDateO | | this . isReleaseOnDate()){ 
" isProductOrReleaseChart = true; 

if (this.isStatusByDate() | | this.isProductByDateO | | 
this . isReleaseByDateO) 

isTimeSeries = true; 

if (isTimeSeries | | this.isStatus0nDate() || this.isProductOnDate() || 
thi s . i sRel ease0nDate()) 

ischart = true; 

// Need to format data for a summary report - 

// get initial DbTime object to figure db and user offset from GMT 

dbt = new DbTime(session, conn); 
dbt2 = new DbTime(session, conn); 

if (isTimeSeries) dbtForTimeSeries = new DbTime(session,conn) ; 


String baseName = ""; 

stringBuffer prsql = new stringBuffer( M ( select i.iterruid, ig.item2_id 
"); /// the subQuery in the from clause -- for releases 

ArrayList releaseCols = new ArrayList(); 

// for local processing 
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ng tmpTable = ""; 

ng tmpltemTypeld = ""; 

ng tmpcolumn = ""; 

ng tmpName = 

ng tmpDisplayType = 
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ii it 

n ii . 


conti nue; 


Stri 
Stri 
Stri 
stri 
Stri 

String tmpType = 

while (ofi . hasNextO) { 

key = (String) ofi. next (); 

if ( key.indexof ("RANGE_START") > -1) 

baseName = key.substring(12) ; 
else if (key.indexof ("RANGE_STOP") > -1) 

baseName = key . substri ng(ll) ; 

else 

baseName = key; 

// Only process valid filter fields 

// 

if ((thisDDE = (DDEntry) filterFields.get(baseName)) == null) 

thisDDE.setName(key) ; 

f = thi s.fg.getFi Iter (key) ; 

//Z.probe("Checking the origFilters for key = " + key); 


ti ii 


tmpTable = thisDDE.getTableName() == null ? 
thisDDE.getTableName() ; 

i f (TextManager . i sst ri ngvi si bl e (thi sDDE . getltemTypeld () ) ) 
tmpltemTypeld = thisDDE.getltemTypeld() ; 

if ("PROBLEM_RELEASE M . equal slgnoreCase(tmpTable) | | 
"1" . equalslgnoreCase(tmpltemTypeld)){ 

tmpcolumn = thisDDE.getCol umnName() ; 
prFi Iters. put (tmpName, "") ; 
if (!addReleaseSql){ 

addReleaseSql = true; 
prsql .append(" , i . "+tmpCol umn + " "); 

} } 

if (this.hr) tmpTable = getHistoryEqui val ent(tmpTabl e) ; 

tmpName = thisDDE.qetName() ; 
tmpDisplayType = thisDDE.getDisplayTypeQ ; 

// Track the multiple value release fields that need to be 

// in a hashmap if DDName/Filter (this is originally for redback) 

if (this.filterchildvalue){ 

i f (" PROBLEM_RELEASE" . equal slgnoreCase (tmpTabl e) ) { 

thi s . suppressedMul ti Rel easeFi Iters. put (tmpName , f ) ; 

} 

} 


suppressed 


// 


searchField") ; 


//z. probe( M checking ddeName = " + ddeName + " and it is a 

rawfc = f .getFilterCriteriaResolved() ; 
criteriasize = rawfc. si ze () ; 
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// debug check. . . 

if (criteriasize == 0) { 

ArrayList fcTest = f .getFilterCriteriaQ ; 

if (fcTest.sizeO > 0; Z.log.writeToLogCz.log. ERROR, "RPT: 
resolved mismatch error:" + f cTest) ; 

} 


Z. dbms . catQ) ; 


i f (TextManager . i sStri ngvi si bl e(thi sDDE . getCol umnNameO)) 

tmpColumn = TextManager . replace(thisDDE.getColumnName() , "||", 

// for finding the optimal index 

if (dri verTabl e . equal slgnoreCase (tmpTabl e)) { 


// Do not process summary fields on charting queries -- they are 
// do not use this index for STOP_UPDATE on piechart queries (a 


special . 

<= not a between) 

// 

// skip the hints for these chart queries — they really si 

things down 

// 

if (ischart){ 

if (is~rimeseries){ 

i f ( 11 START_U PDATE " . equal slgnoreCase(tmpName)) { 
startTimeSeriesDate = (String)rawfc.get(O) ; 
continue; // skip this one 

} 

el se i f ("STOP_u PDATE" . equal slgnorecase(tmpName)) { 

/* if C m STATUS_hist m . equal signoreCase(ddeName) 
| | "STATUS" . equal slgnoreCase(ddeName)) 
continue; 

else if ("PRODUCT_NAME_HlST" . equal slgnoreCase (ddeName) 
I | "PRODUCT_NAME" . equal slgnoreCase (ddeName)) 
continue; 

else if ("RELEASE_FOUND_HlST". equal slgnoreCase (ddeName) 
I | "RELEASE_FOUND" . equal slgnoreCase (ddeName)) 
continue; 

// else if (! ( "STOP_u PDATE " . equal slgnoreCase(ddeName) || 
"START_u PDATE" . equal slgnoreCase (ddeName)) ) 

// probl emCol umns . put (ddeCol umn , f ) ; 

V 

} 

else probl emCol umns. put (tmpColumn, f ) ; 
// if its not a date 

if ( ! "DATE" . equal slgnoreCase(tmpDi spl ayType)) { 


ow 


conti nue; 


// don't do the keyword criteria if its an attachment alert 
if ("KEYWORD". equal slgnoreCase(tmpName) && doAttachAlert) 

else filters. put (tmpName, f ) ; 
conti nue; 

} 
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// if its a date equivalence then add it 
if ( ! (tmpName . i ndexof ("RANGE_START") > -1 

tmpName.indexOf ("_SINCE") > -1 
tmpName.indexOf ("RANGE_STOP") > -1) ){ 
filters. put (tmpName, f) ; 
continue; 

} 

// check for the same date column multiple times 

if ((tmpf = (Filter) startDates.get(baseName)) == null) { 

startDates . put (baseName , f ) ; 

filters. put (tmpName, f) ; 

} 

// already have one date so another means we use between (instead of 

// clear out the last filter entry for this field and make the new 
// filter entry a between with 2 dates — the start date is [0], 


else { 

tempDDName = tmpf . getDDName() ; 
fc = new ArrayLi st () ; 

//Z.probe("BETWEEN DATE tmpDDNAME = " + 

// tempDDName + " filter criteria = " + 
tmpf . getFi 1 tercri teri a()) ; 

//Z.probe( M BETWEEN DATE tmpDDNAME = " + 

// tempDDName + " filter criteria(O) = " + (String) 
tmpf ,getFilterCriteria() .get(0)) ; 

// set the criteria from the first found instance of this field 
// then set the criteria from the current — make sure they are 


pai red up 


iet(0)); 


enforce 


removeFi rstDate = false; 

if (tempDDName. i ndexof ("RANGE_START") > -1 
I tempDDName. i ndexof ("_SINCE") > -1) { 
: c . add (tmpf . getFi 1 tercri teri aResol ved() . 
if (tmpName.indexOf ("RANGE_STOP") > -1) 
fc.add(rawfc.get(0)) ; 
removeFi rstDate = true; 

} 

} 

else if (tempDDName. i ndexof ("RANGE_STOP M ) > -1) { 
if (tmpName.indexOf ("RANGE_START") > -1 
I tmpName.indexOf (".SINCE") > -1) { 
: c . add ( rawf c . get (0) ) ; 
removeFi rstDate = true; 

} 

f c . add (tmpf . getFi 1 tercri teri aResol ved() . get (0)) ; 

} 

// set the criteria from this current instance of this field 

// note that if the user laid out the screen properly there 
// should be one START and one STOP only - so i will check to 

// NOW if any DATE type has 2 FILTER CRITERIA and the ddName 
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contains the string 

// STOP / START / SINCE it will be treated as a BETWEEN 


// 


if (removeFi rstDate) { 

filters. remove (tempDDName) ; // remove the last 
f . setFi 1 terCri teri a(f c) ; 

filters. put (tmpName, f ) ; // add the current 

} 

else { 

fi Iters . put(tmpName, f ) ; 
continue; 

} 

2. log. writeToLog(Z.log. DEBUGS, "THE ORIG FILTERS ARE : " 
+origFi 1 ters . tostri ng()) ; 

Z.log.writeToLog(z.log.DEBUG5, "THE PRE PROCESSED FILTERS ARE : " 
+fi Iters. tostri ng()) ; 

OICCol lection oil = 
Z . dbms . getProbl emTabl eOpti mi zedlndexHi nt (probl emcol umns , conn) ; 

/// DEBUG 

STUFF 

//Z.probe(" INDEX COLUMN ANALYSIS : probl emcol umns=" + probl emcol umns) ; 
//if (oil != null) { 

//z. probe (" INDEX column ANALYSIS : oil.size()=" + oil.sizeO); 
//if (oil.sizeO > 0) { 

//for (int k = 0; k < oil .getlndexHintAr ray (). length; k++) 

//z.probe(" index column analysis : oil .getindexm ntArray()=" + 
oi 1 . getlndexHi ntAr ray () [k] ) ; 

//for (int k = 0; k < oil .getTableAli asAr ray (). length; k++) 
//Z.probe(" INDEX COLUMN ANALYSIS : oil .getTableAli asArray()=" + 
oil .getTableAliasArrayO [k]) ; 

//} 
//} 

// DEBUG 


STUFF 


//!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 
// variable params for history reporting 
// if (this.hr) { 

// this.driverTable = "ITEM_HIST"; 

// ITEM = "ITEM_HIST" ; 

// ITEM^TEXT = "ITEM_TEXT_HIST"; 

// ITEM_UDF = "ITEM_UDF_HIST" ; 


//z. probe ( 
//Z. probe ( 
//Z. probe( 
//Z. probe ( 


"~!@ - this.hr="+this.hr); 

"~!@ - this.driverTable=" +this.driverTable) ; 

"~!@ - ITEM="+ITEM) ; 
,f -!@ - ITEM__TEXT="+ITEM_TEXT) ; 
//Z. probe ("~!@ - ITEM_UDF="+ITEM_UDF) ; 
//} else 

this.driverTable = "ITEM"; 


I J it ****************************************************** 
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// 

// GET THE PRE-SORT INFO 

// 

SortOrderField sof = null; 
Sortorder thisso = null; 
thisSo = this. so; 

if C ( (thisso == null) 

|| (thisso. getFields0.get("ID") == null) ) && 
! i sSummaryReport () ) { 

sof = new SortOrderField() ; 
sof .setDDName("lD M ) ; 

if (thisso != null) sof . setOrderRank(thisSo.getFields() .size()) ; 
else{ 

sof . setOrderRank(O) ; 
thisSo = new SortOrderO; 

} 

sof .setSortDi rection("DESC") ; 
thi sso . addFi el d(sof ) ; 

Z.probe("RPT: ! ! ! ! ! IADDED DEFAULT SORT ORDER ID DESC" ); 

else thisSo = this. so; 

Iterator soi = thisSo. getFields() . keyset() .iterator() ; 

boolean useOJRelease = false; 
boolean useOJModule = false; 
boolean useOJRelationshi pGroup = false; 
boolean useOJ = false; 

prSorts.clear() ; 

while (soi .hasNext()){ 

//Z. probe("pre-sort-Order ddeTable / itemType is " + ddeTable + " / 
" + ddeltemTypeld) ; 

key = (Stri ng)soi . next() ; 

sof = thisso. getFi el d(key) ; 

thisDDE = (DDEntry) (sortFields.get(key)) ; 

if (thisDDE == null) continue; 

if (thisDDE.getTableNameO != null) 
tmpTable = thisDDE.getTableNameO; 

if (this.hr) tmpTable = getHistoryEqui valent (tmpTable) ; 

if (thisDDE.getltemTypeldO != null) 

tmpltemTypeld = thisDDE.getltemTypeldO; 
else tmpltemTypeld = ""; 


i f (" PROBLEM_RELEASE" . equal slgno reCase (tmpTabl e) 
I | "1" . equal slgnoreCase(tmpltemTypeld)){ 
prsorts . put(thi sDDE.getName() , thi sDDE) ; 
// continue; 

tmpColumn = thisDDE.getColumnName() ; 
if (!addReleaseSql){ 
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addRel easeSql = true; 

if ( prFilters.get(tmpName) == null && prSorts.get(tmpName) 
prsql .append(" , i . "+tmpColumn + " "); 


} 


if (thisDDE.getColumnName() != null) 

tmpcolumn = TextManager . replace( thisDDE.getColumnName() , "I I " , 

Z.dbms.catO ); 

else tmpcolumn = ""; 

if ( tmpTabl e . startsWi th (" PROBLEM_RELEASE") 

&& ("RELEASE_FOUND" .equal slgnorecase(tmpcolumn) 

I | "PRODUCT^NAME". equal signorecase (tmpcolumn); ){ 
useOJRelease = true; 

} 

else if ( tmpTable.startsWith( ,, PROBLEM_MODULE M ) 

&& "M0DULE_ID". equal slgnoreCase(tmpColumn) ){ 
useOJModule = true; 

} 

else if ( tmpTable. startsWi th( M RELATIONSHIP_GROUP") 

&& ( M PARENT_PROBLEM_ID M . equal slgnoreCase(tmpColumn) 

|| M RELATIONSHIP_GROUP_lD". equal slgnoreCase(tmpColumn)) ){ 
useOJRelationshipGroup = true; 

} 

}// end pre-sort order 


boolean isRel easel temTypeSet = false; 

// finish getting sort order info 

re = new ReportElement(null , oil, isChart, hr); 
re.toLog(Z. log.DEBUG5) ; 

boolean skipPreCondi tion = false; 
boolean doCaselnsensi tive = this.isCaselnsensitive; 


" . PRIVACY) 



if (doCaselnsensi tive) precondition. append(" OR UPPER("+ 
re.getITEM() + ".ORIGINATOR) = UPPER(?) "); 

else precondition. append(" OR UPPER("+ re.getlTEM()+ ".ORIGINATOR) = 

UPPER(?) "); 

paramsPreCondi tion. add (su. getld()) ; 
typesPreCondi ti on . add ("STRING") ; 

if (doCaselnsensi tive) precondition. append(" OR upper("+ 
re.getlTEMO + " . ASSIGNED_TO) = UPPER(?) "); 

else preCondition.append(" OR "+ re.getlTEM() + " . ASSIGNED_TO= ? ") ; 
paramsPreCondi ti on . add (su . getld () ) ; 
typesPreCondi ti on . add ("STRING") ; 
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if (docaselnsensi tive) precondition. append(" OR UPPER("+ 
re.getlTEM() + ".OWNER) = UPPER(?) "); 

else precondition. append(" OR "+ re.getITEM() + ".OWNER = ? "); 
paramsPreCondi tion. add (su.getldO) ; 
typesPreCondi ti on . add("STRING") ; 

if 

("YES" . equal sIgnoreCase(z . appDef aul ts . getAttri bute("ENABLE_COMPANY_NAME^ACCESS"))) { 

string companyName = su.getCompanyName() ; 

// If my CompanyjMame from Securi ty_User = Company_Name from 
Application Default... 

// or if my companyjMame is null then I should be able to see 

all records, 

// regardless of PRIVACY. 

//Z.probe(" companyName =" +companyName) ; 
//Z . probe ("Z . appDef aul ts . getAttri bute (COMPANY_NAME) ="+ 
Z . appDef aul ts . getAttri bute ("COMPANY_NAME") ) ; 

i f (TextManager . i sSt ri ngvi si bl e (companyName) ) { 
if 

(companyName . equal s (Z . appDef aul ts . getAttri bute ("COMPANY_NAME ,f ))) { 

skipPreCondi tion = true; 

} 

else { 

precondi tion.append(" OR exists (select 1 from ITEM p, 


SECURITY_USER SU " + 
+ 


where SU.SECURITY_USER_ID = p. ORIGINATOR " 


= UPPER(?) ) "); 


"); 


} 


and p." + PROBLEM_KEY + " = "+ 
re.getDriverAlias() +"." + PROBLEM_KEY) ; 

if (docaselnsensi tive) 

precondition. append(" and UPPER( su . C0MPANY_NAME ) 

else 

precondition. append(" and su.COMPANY_NAME = ? ) 

paramsPreCondi tion . add (companyName) ; 
typesPreCondition.addrsTRlNG*) ; 


} 


} 

else { 

ski pPreCondi tion = true; 


if 

("YES".equalsIgnoreCase(Z.appDefaults.getAttribute("ENABLE_PRIVACY_GROUPS"))) { 

su . setconnection(conn) ; 
ArrayList pg = su.getPrivacyGroups() ; 

//Z. probe("This users privacy group is null = " + (pg==null)); 
if (pg != null) { 

//Z. probe("This users privacy group size is = " + 

pg.sizeO) ; 

if (pg.sizeO > 0 && pg.sizeO < 20) { 

if (docaselnsensi tive) precondition. append(" OR UPPER("+ 
re. getlTEM()+". PRIVACY ) in ("); 
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else precondition. append(" OR "+ re. getITEM()+ M . privacy 

in ("); 

int k = 0; 

for (k = 0; k < pg.sizeQ; k++) { 

if (k > 0) precondition. append(" , "); 
precondition. append ("?") ; 
if (docaselnsensi tive) 

precondition. append ( M UPPER(?)") ; 

paramsPreCondi ti on. add ((St ring) pg .get(k)) ; 
typesprecondi ti on . add ("STRING ) ; 

preCondi ti on . append (") ") ; 

else if (pg.size() > 0) { 

precondition. append(" OR " + re.getITEM() + ".PRIVACY in 

"( select PRIVACY_GROUP_ID " + 

" from PRIVACY_GROUP__USER where SECURITY_USER_ID 

= ? )"); 

paramsPreCondi ti on. add ((St ring) su.getldO) ; 
typesprecondi tion. add("STRlNG ) ; 

} 

} 

} // end enable privacy groups 
} // end system and admin 

if (skipPreCondi tion) { 

precondition. setLength(O) ; 
paramsPreCondi ti on . cl ear () ; 
typesprecondi tion . cl ear () ; 


// LOOP THROUGH THE FILTERS AND BUILD THE QUERY STRING 

// 

boolean i sProbl emltemTypeSet = false; 

int timeSeriesDateParamPositions[] = {0,0}; // what is this ??? 

Iterator fi = filters. keySetO .iterator() ; 

Calendar startTimeSeriesCalendar = null; 
Calendar endTimeSeriesCalendar = null; 

String token = ""; // for use with ALLOWED_SEARCH_FILE_EXT 
boolean hasNullToken = false; 

String andor = ""; 
String operator = ""; 

Filter tempFilter = null; 

while (fi .hasNextO) { 


key = (string) fi.next(); 

if ( key . i ndexof ("RANGE_START") > -1) 

baseName = key . substri ng(12) ; 
else if (key. i ndexof ("RANGE_STOP") > -1) 

baseName = key . substri ng(ll) ; 

else 

baseName = key; 
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tempFilter = (Fil ter)fil ters.get(key) ; 
andor = tempFilter.getAndor() ; 
operator = tempFilter.getOperatorO ; 

// Only process valid filter fields 

if ((thisDDE = (DDEntry) filterFields.get(baseName)) == null) 

conti nue; 

re = new ReportElement(thisDDE, oil, ischart, hr); 
re . toLog (Z . I og . DEBUGS) ; 

if (ischart) { 

thi s . dri verTabl e = M ITEM_HIST M ; 
re . setDdeTabl e ("ITEM_HIST") ; 

} 

appendchartDate = ischart; 

if (lisReleaseltemTypeSet && addReleaseSql) { 

if (ischart) prSql . append(" from item_group ig, item_hist i 
where i .item_type_id = 1 and i.item_id = ig.iteml_id and i .change_type <> 1 D f ) 

else prSql ,append(" from itemaroup ig f item i where 
i . i tem_type_i d = 1 and i.item_id = ig.iteml_id ) ); 

jd.addAll (prSql .tost ring () , 

PR 

id . LEFT_DOIN , 
ITEM2_ID" , 

re.getDriverAliasO , 

DRIVER_KEY, 

l); 

isReleaseltemTypeSet = true; 

di s ti nctTabl es . put (" PR" , thi sDDE) ; 

} 

f = fg. getFi Iter (key) ; 

rawfc = f .getFilterCri teri aResol ved() ; 

fc = new ArrayListO; 

criteriaSize = rawf c . si ze() ; 

// debug check. . . 

if (criteriaSize == 0) { 

ArrayList fcTest = f .getFilterCri teria() ; 

if (fcTest.size() > 0) 2.1og.writeToLog(Z.log.ERROR, "RPT: 
resolved mismatch error:" + f cTest) ; 

} 

hasNull Criteria = false; 


// PREQUERY OPERATIONS - TEST FOR WILDCARS IN FILTER CRITERIA 

// 

// if there is an "*" in the criteria, replace the wildcard wit 

DBMS. wildcard 

// and do LIKE queries 
wildcards = false; 
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for (int k = 0; k < cri teri asize; k++) { 
rawvalue = (string) rawfc. get(k) ; 
processedvalue = TextManager. replace(rawvalue, "*" , 


true; 


cri teri aTabl eCol umn . setLength(O) ; 

if ("{nun} M .equalslgnoreCase(processedvalue)) hasNullCri teria = 

i f ("USER" . equal slgnoreCase(re . getDdeDi spl ayType() ) ) 

f c . add(processedVal ue . toUpperCase(Z. defaul tLocal e)) ; 

else 

fc. add (processedvalue) ; 

Z. log. writeToLog(Z. log. DEBUG, "RPT: raw/processed=" + rawvalue + 
"/" + processedvalue); 

if (rawvalue. indexof ("*") > -1) wildcards = true; 

} 

if ("DATE". equals (re. getDdeDi spl ayType())) { 
if (isTimeSeries){ 

try{ 

startTimeSeriesCalendar = 
Convert .getCalendarFromStringWithMask(hasNullCri teria ? : startTimeSeriesDate, 

dbt.getMaskFromDateFormat(su.getDateFormatO) ) ; 

} 

catch(Exception e){ 

startTimeSeriesCalendar = 
Convert .getcal endar Fromst ring (session, 

hasNullCriteria ? "" : StartTimeSeriesDate); 

} 

try{ 

endTimeSeriesCal endar = 
Convert .getCalendarFromStringWithMask(hasNullCriteria ? : stopTimeSeriesDate, 

dbt.getMaskFromDateFormat(su.getDateFormat())) ; 

catch(Exception e){ 

endTimeSeriesCal endar = 
convert . getcal endarFromSt ri ng (sessi on , 

hasNullCriteria ? : stopTimeSeriesDate); 

} 

dbt2 . setUserNow(endTi meseri esCal endar) ; 

dbtForTi meseri es . setUserNow(startTi meseri esCal endar) ; 

} 

else startTimeSeriesCalendar = 
Convert. getCalendarFromString(session, (String) (hasNullCriteria ? "" : fc.get(O)) 

); 

dbt . setUserNow(startTi meseri esCal endar) ; 

if (fc.sizeO > 1) 
try{ 


dbt2 . setuse rNow(Convert . getcal endarFromSt ri ngwi thMask( (St ri ng) (hasNul 1 Cri teri a ? 
: fc.get(l)), 

dbt .getMaskFromDateFormat(su.getDateFormatO))) ; 

catch(Exception e){ 

dbt2 . setuse rNow(Conve rt . getcal endar FromSt ri ng (sessi on , 
(String) (hasNullCriteria ? "" : f c . get (1)))) ; 
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* PROCESS KEYWORD « NEVER FOR A HISTORY REPORT — CRAZY 

* 

V 

// TO DO — search release level text 

// 

if ("KEYWORD" . equal signoreCase(re.getDdeNameO)) { 
andKeyword. append(andOr + " ( "); 
andKeyword. appendC ( ") ; 

// Look in the short_desc 

// 

for (int k = 0; k < cri teriasize; k++) { 
if (k > 0) andKeyword. appendC and "); 

andKeyword. append("UPPER(" + re.getlTEM() + " .short_descr) 

"); 

andKeyword. appendC LIKE '" + z. dbms .WILDCARD() + " + 

Z.dbms.catO 

+ " upper(?) " + Z.dbms.catO + + 

Z.dbms.WlLDCARD() + ); 

paramsKeyword. add((Stri nq) f c .get(k)) ; 
typesKeyword.add("STRlNG ) ; 

andKeyword. append(") ") ; 
andKeyword. appendC or "); 

// Look in the problenutext 

// 

andKeyword. append("exists ( "); 

andKeyword. appendC select " + keywordHint + " 'x' from " + 

re . getlTEM_TEXT() + 

" where " + re . getiTEM_TEXT() + + 

PROBLEM_KEY + 

" = " + re.getITEM() + . + PROBLEM_KEY + " 

and "); 

andKeyword. append(" ( 

for (int k = 0; k < cri teriasize; k++) { 
if (k > 0) andKeyword. append(" and "); 

andKeyword. append( ,, UPPER(" + re . getlTEM_TEXT() + ".text) ") ; 
andKeyword. append(" LIKE '" + z.dbms.WILDCARD() + + 

Z.dbms.catO 

+ " upper(?) " + Z.dbms.catO + + 

Z.dbms.WILDCARDO + ); 

paramsKeyword. add ((St ring) fc.get(k)) ; 
typesKeyword.add("STRlNG rt ) ; 

andKeyword. append(") ") ; 
andKeyword. append(") ") ; 

andKeyword. append(" or ") ; 

// Look in the attachment desc 

// 

andKeyword. appendC exists ( ") ; 

andKeyword. appendC select 'x' from " + re . getATTACHMENT() + 

" where " + re. get ATTACHMENT () + ".item_id = " 
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+ re.getlTEM() + "." + problem_key + " and ,r ) ; 

andKeyword. append (" ( "); 
for (int k = 0; k < cri teriasize; k++) { 
if (k > 0) andKeyword. append(" and "); 
andKeyword. append ("UPPER(" + re . getATTACHMENT() + 


" . FILE_DESC) "); 

Z. dbms . cat() 

Z.dbms.WILDCARD() + ); 


andKeyword. append(" LIKE ' " + Z.dbms.WILDCARD() + 
+ " upper(?) " + z. dbms. cat Q + + 


it • ii 


paramsKeyword.add((Strinq) fc.get(k)) ; 
typesKeyword. addC'STRING 11 ) ; 

} 

andKeyword. append(") ") ; 
andKeyword. append(") "); 

// Look in the BLOB 

// 

if (this.searchAttach) { 

andKeyword. append("or exists ( "); 

andKeyword. append(" select 1 x f " + 

" from attachment a, attachment_content ac " + 
" where ac. attachment^' d = a. attachments d " + 
" and a. itemed = " + re.getITEM() + ■ + 

PROBLEM_KEY + 

" and a.content_type in ("); 
String okExtensions = 

Z . appDef aul tS . getAtt ri bute ("ALLOWED^VrTACH_SEARCH_FILE_EXT") ; 

StringTokenizer st = new StringTokenizer(okExtensions, ' 

ArrayList orderedcol umnNames = new ArrayListQ; 
int cnt = 0; 

while (st . hasMoreTokens() || cnt == 0) { 
cnt++; 

if (okExtensions. indexOf(" ,") == -1) { 
paramsKeyword.add(okExtensions) ; 
typesKeyword . add ("STRING") ; 
andKeyword . append("?") ; 

} 

else { 

if (cnt > 1) andKeyword. append(", ") ; 

token = (string) st . nextToken() ; 

i f (" \"\" " . equal slgnoreCase(token)) { 

token = 7,11 ; 

hasNullToken = true; 

} 

paramsKeyword.add(token) ; 
typesKeyword . add("STRlNG") ; 
andKeyword. append( M ?") ; 

} } 

andKeyword. append(")") ; 

if (hasNullToken) andKeyword. append(" or a. content_type 

null "); 

andKeyword. append(" and "); 

andKeyword. append(" ( "); 

for (int k = 0; k < cri teriasize; k++) { 

if (k > 0) andKeyword. append(" and ") ; 

Blobsearchlnfo bsi = Z.dbms.bloblnstr("ac.content_bl 
"?", (String) fc.get(k), loc); 
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andKeyword.append(bsi .getsql ()) ; 
paramsKeyword.addAll (bsi .getParamsO) ; 
typesKeyword.addAl 1 (bsi .getTypesO) ; 

andKeyword.append(") ") ; 
andKeyword.append(") ") ; 


}// end if search attach 
andKeyword.append(") ") ; 


} 


^/******* ********************** ******** *********************** 

* using wildcards not for history reports 

* 

* 

* will be using LIKE instead of IN 

* 

V 

else if (wildcards) { 

//Z.probe("RPT:in build wildcards"); 


// Process Wildcard UDFs 

// . 

if ("UDF" . equal slgnoreCase(re . getDdeTypeO) ) { 
andUDF.appendCandor + " exists "); 
andUDF.append(" (select 1 " + 

" from " + re.getITEM_UDF() + 

" where " + re.getlTEM_UDF() + "." + 


it it 


+ re.getlTEM() + "." + PROBLEM_KEY + 

" and " + re.getITEM_UDF() + ".udf_id = ? 

paramsUDF.add(((Udf) udfs.get(re.getDdeName())) .getudfld()) ; 
typesUDF . add("STRING M ) ; 

//filter criteria loop 

for (int k = 0; k < cri teriasize; k++) { 

if (k == 0) andUDF.append(" and "); 

else andUDF.append(" or "); 

andUDF.append(* f UPPER(" + re.getITEM_UDF() + "/'); 

if ("NUMBER" . equal slgnoreCaseQre . getDdeDi spl ayType())) { 

andUDF . append( M val ue_number") ; 
} else { 

andUDF.append("value") ; 

} 

andUDF.append(") "); 
andUDF.append(" LIKE UPPER(?) "); 
paramsUDF.add((Strinq) fc.get(k)) ; 
typesUDF. add( M STRlNG) ; 

andUDF.append(") ") ; 
// Process Wildcard Driver Table Fields - ie in Problem Table 


// 


else if (driverTable.equalslgnorecase(re.getDdeTable())) { 
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//filter criteria loop 

for (int k = 0; k < cri teriasize; k++) { 

if (k == 0) andProblem.append(andOr +" ( "); 
else andProblem. append(" or "); 

andProblem. append( v, UPPER(" + re.getTAliasO + "." + 

re.getDdeColumnO + ") ") ; 

andProblem. append(" LIKE UPPER(?) "); 
paramsProblem.add((Strinq) fc.get(k)) ; 
typesProblem.add("STRING rt ) ; 

andProblem. append (") ") ; 

} 

// Process Wildcard Non-Driver Table Fields - ie in Problem 
Release or Problem Module 

// - build an exists clause for these 


// 


else { 

if ((andExists = (Stri ngBuffer) 
existclauses .get(re.getDdeTable())) == null) { 

andExists = new stringBufferO ; 
paramsExists = new ArrayListO; 
typesExists = new ArrayListO; 

if (re.getHasGrandParentTableQ) { // this is never a 


history reporting thing 

re.getTAliasO + 
re.getDdeChildKeyO + 
re.getDdeParentKeyO + 
re.getDdeGrandParentKeyO + 
re . getDdeGrandchi 1 dKey () ) ; 


// also never a view thing 

andExists. append(" exists (select 1 from " + 

" where " + re.getTAliasO + . + 

" = " + re.getPtAliasO + • + 

" and " + re.getGptAliasO + "." + 

" = " + re.getPtAliasO + + 


} else { 

andExists. append(" exists (select 1 from " + 

re.getTAliasO + 

" where " + re.getTAliasO + . + 

re.getDdeChildKeyO + 

+ re.getPtAliasO + + 

re.getDdeParentKeyO + " "); 

} 

} else { 

paramsExists = (ArrayList) 
exi st Params . get (re . getTAl i as () ) ; 

typesExists = (ArrayList) 
exi stTypes . get (re . getTAl i as ()) ; 

//filter criteria loop 

for (int k = 0; k < cri teriasize; k++) { 

if (k == 0) andExists. append( M and ( "); 
else andExists. append(" or "); 

andExists. append(* f UPPER(" + re.getTAliasO + "." + 

re.getDdeColumnO + ") ") ; 

andExists. append(" LIKE UPPER(?) ") ; 
params Exi sts . add ((Stri ng) f c . get (k)) ; 
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typesExi sts . add ("STRING") ; 

if (criteriasize > 0) andExists.append(" )"); 
andExists.append(" )"); 

/* 

// deal with release level UDFs special case 


if ("UDF". equal slqnoreCase(ddeType) && 
! ("l".equalslgnoreCase(ddeItemTypeld)) ) { 

andUDF.append( ,! and exists "); 
andUDF.append(" (select 1 " + 
" from " + ITEM_UDF + 

" where " + ITEM_UDF + "." + problemKey + " = " + ITEM + 

" . " + problemKey + 

" and " + ITEM_UDF + ".udf_id = ? "); 
paramsUDF.add(((Udf) udfs.get(ddeName)) .getUdfldO) ; 
typesUDF.add("STRlNG") ; 

//filter criteria loop 

for (int k = 0; k < criteriasize; k++) { 

if (k == 0) andUDF.append(" and "); 

else andUDF.append(" or ") ; 

andUDF.appendC' UPPER(" + ITEM_UDF + "-"); 

if ("number" . equal slgnorecase (ddeDi spl ayType)) { 

andUDF.appendC value_number") ; 

} else { 

andUDF. append ("value") ; 
} 

andUDF.append(") ") ; 
andUDF.append( M LIKE UPPER(?) "); 
paramsUDF.add((Strinq) fc.get(k)) ; 
typesUDF.add("STRlNG rt ) ; 

} 

andUDF.append(") "); 
} 

V 


existClauses.put(re.getTAlias() , andExists) ; 
existParams.put(re.getTAlias() , paramsExists) ; 
existTypes.put(re.getTAlias() , typesExi sts) ; 
existAndOrs.put(re.getTAlias() ,andOr) ; 

Z.probe("RPT:wildcard»»>existClauses " + existclauses) ; 
Z.probe("RPT:wildcard»»>paramsExists " + paramsExists); 

} // end if wildcards 


else { 


f-tc-ie ************************** ************** 

* Not using wildcards 

* 

V 

// Process the UDFs 

if ("UDF".equalslgnoreCase(re.getDdeType())) { 
//Z.probe("RPT:lN UDF " + ddeName) ; 
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// if --none-- is the selected value 
if (hasNullcri teria && criteriasize == 1) { 
andUDF.append(andOr +" not exists "); 
andUDF.append(" (select 1 " + 

h from " + re.getlTEM_UDF() + 

" where " + re.getlTEM_UDF() + "." + 

PROBLEM_KEY + 

" =" + re.getlTEMO + "." + problem_key) ; 
if (this.hr) { 

andUDF.append(" and " + re.getITEM_UDF() + . + 
getHistKey(re.getlTEM_UDF() , true) + 

" = " + re.getlTEMO + "." + 

getHistKey (re.getlTEMO , false)) ; 

andUDF.append(" and " + re.getlTEM_UDF() + ".udf__id 

= ? ) "); 

paramsUDF.add(((Udf) 
udfs.get(re.getDdeName())) .getudfldO) ; 

typesUDF . add( M STRlNG M ) ; 

} 

else { 

andUDF.append(andOr + " exists "); 

if (hasNullCriteria) andUDF. append(" ( "); 

andUDF.append(" (select 1 " + 

>f from " + re.getITEM_UDF() + 

" where " + re.getlTEM_UDF() + "-" + 

PROBLEM_KEY + 

" =" + re.getlTEMO + * + PROBLEM_KEY) ; 
// if (this.hr) { 

// andUDF.append(" and " + ITEM_UDF + + 

getHistKey(lTEM_UDF f true) + 

// " =" + item + . + getHistKey (ITEM, false)); 

andUDF.append(" and " + re.getITEM_UDF() + ".udf_id 


= ? "); 


paramsUDF.add(((Udf) udfs.get(baseName)) .getudfldO) ; 
typesUDF. add ("STRING") ; 


matched 


//TODO: - make this a method 

// test for UDF Type — this determines what field is 


i f ("LIST" . equal slgnoreCase(re . getDdeDi spl ayTypeO) 

"POPUP", equal slgnoreCase( re. getDdeDispl ayTypeO) 
"TAB" . equal slgnoreCase(re . getDdeDi spl ayTypeO)) 
cri teri aTabl eCol umn . append (re . getlTEM_UDF() + 

,? .udf_list^id M ); 

else if 

("DATE" . equal slgnoreCase (re . getDdeDi spl ayType () ) ) 

cri teri aTab 1 eCol umn . append(re . getlTEM_UDF() + 

".value_date") ; 

else if 

("NUMBER" . equal slgnoreCase (re. getDdeDi spl ayTypeO)) 

cri teri aTabl eCol umn . append(re . getITEM_UDF() + 

" . val ue_number") ; 

else{ 

if (docaselnsensi tive) 
cri teri aTabl eCol umn . append("UPPER("+re . getITEM_UDF()+ " . val ue) ") ; 

cri teri aTabl eCol umn . append(re . getITEM_UDF() + 

".value"); 

} 
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// if (hasNull Criteria) 

// andUDF. append(" and (" + cri teriaTableColumn) ; 

// else 

andUDF. append (" and " + cri teriaTableColumn) ; 


// do between 


if ("DATE" . equal slgnoreCase(re . getDdeDi spl ayType())) { 

if (criteriasize > 1) { 

andUDF. append(" between ? and ? )"); 
paramsUDF. add (dbt.qetDbNowTimestampO) ; 
typesUDF . add ("DATE ) ; 

paramsUDF. add(dbt2 .getDbThenTimestamp(l)) ; 
typesUDF . add("DATE") ; 

} 

else { 

if (re. getDdeName().indexof ("START") > -1) { 
andUDF. append(" >= ? )"); 
paramsUDF. add (dbt.qetDbNowTimestampO) ; 
typesUDF. add("DATE rt ) ; 

} 

else if (re.getDdeName() .indexof ("stop") > -1) { 
andUDF.append(" <= ? )"); 

paramsUDF. add (dbt.getDbThenTimestampLessOneMinuete(l)) ; 

typesUDF. add("DATE") ; 

} 

else { 

andUDF.append(" between ? and ? )"); 

paramsUDF. add (dbt.getDbThenTimestampLessoneMinuete(l)) ; 

typesUDF. add("DATE") ; 

} } 

} 

else { 

// build the string for multiple criteria values 

andUDF.append(" in ( "); 

//filter criteria loop 

for (int k = 0; k < cri teriasize; k++) { 
if (hasNul lcri teria) { 

if ("{null}" . equal slgnoreCase( (St ring) 

fc.get(k))) { 

skipcomma = true; 
continue; 

} } 

if (k > 0 && iskipComma) andUDF. append(" , "); 
skipcomma = false; 
if (doCaselnsensi ti ve && !( 
"LIST" . equal slgnoreCase(re . getDdeDi spl ayType () ) 

I | " POPUP" . equal slgnorecase (re . getDdeDi spl ayType () ) 

| | "TAB" . equal slgnorecase (re . getDdeDi spl ayType () ) 

| | "number" . equal slgnorecase (re . getDdeDi spl ayType ())) ){ 

andUDF. append("UPPER(?)") ; 
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else andUDF.appendC"?"); 

paramsUDF.add((Strinq) fc.get(k)) ; 
typesUDF . add ("string ) ; 

andUDF.appendC") ") I //end in criteria 
andUDF.appendC") ") ; // end exists 

if ChasNullCriteria){ 

// THE OLD WAY 

//andUDF.appendC" or " + criteriaTableColumn + " is null ) "); //end or is null 

andUDF.appendC") or not exists "); // car mod 
andUDF.appendC" Cselect 1 " + 

h from "+ re.getlTEM_UDFC) + 
" where "+ re.getITEM_UDFC) + 

".item_id=" + 

re.qetlTEMC) + ".iterruid "); 
if Cthis.hr){ 

andUDF.appendC" and "+ re.getlTEM_UDFC) + 

"." + getHistKeyCre.getlTEM_UDFC) ,true)+ 

" = " + re.getlTEMC) + "." + 

getHistKeyCre.getlTEMC) , false)) ; 

} 

andUDF.appendC" and "+ re.getITEM_UDFC) + 

".udf_id = ? ) "); 

//andUDF.appendC" ) "); // car mod 
paramsUDF.addC C 
Cudf)udfs.getCre.getDdeNameO) ) .getudfldC) ) ; 

typesUDF. addC"STRlNG") ; 

} 

} 

} // end test for {null} 
} // end test for UDFs 

// Process Driver Table Fields 

// 

else if CdriverTable.equalslgnoreCaseCre.getDdeTableO) 

|| Cischart 

&&C"STATUS_HIST" . equal slgnoreCaseCre . getDdeTabl e 0 ) II 

"ITEM_HIST". equal slgnoreCaseCre.getDdeTableO) ) ) 

| | Cischart && 
"ITEM" . equal SlgnoreCaseCre.getDdeTableO)) 

{ || ■■PR».e q u.l S10 norec«e(re. g et I T E MO) ) 

Z . 1 og . wri teToLog CZ . 1 og . DEBUG4 , " — @ — RPT : Processi ng Dri ver 
Table Fields " +re. getDdeTabl eC)+ for DDEntry " + re.getDdeNameO) ; 

//Z.probeC"RPT:lN DRIVER TABLE " + ddeName) ; 

i f C"STATUS_HIST" . equal slgnorecase Cre . getDdeTabl e C) ) ) { 
if CdistinctTables.getCre.getTAliasO) == null){ 
di sti nctTabl es . put Cre . getTAl ias(), thi sDDE) ; 

f romCnt++; 

jd.addAll Cre.getDdeTableC) , re. getTAl i as C) , jd.lNNER_JOlN, re . getDdeChi 1 dKeyC) , re.getPt 
Al i as C) , re . getDdeParentKey C) , 1) ; 

} } 
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// el se i f ("ITEM_HIST" . equal slgnoreCase(ddeTabl e) { 
// if (distinctTables.get(tAlias) == null){ 

// distinctTables.put(tAlias, thisDDE); 

// 

// fromCnt++; 

// j d . addAl 1 (ddeTab 1 e , tAl i as , " " , " " , "" , " " , 0) ; 

// } 

// } 


if (doCaselnsensi tive && 
! "date" . equal slgnoreCase (re . getDdeDi spl ayType () ) ) 

cri teri aTabl eCol umn . append("UPPER("+re . getTAl i as () + 
+ re.getDdeColumnO+")") ; 

else if ("DATE", equal slgnoreCase(re. getDdeDi spl ayTypeO) && 

isChart) 

cri teri aTabl eCol umn . append ("t rune ("+re . getTAl i as () + 

+ re.getDdeColumn()+") M ) ; 

else 

cri teri aTabl eCol umn. append(re. getTAl i as () + "." + 


ii it 


re.getDdeColumnQ) ; 


it 


); 


"); 


if (hasNullCri teria && criteriasize > 1) 

andProblem.append(andOr + " (" + cri teri aTabl eCol umn + 

else 

andProblem.append(andOr + " " + cri teri aTabl eCol umn +" 


n 


// check for calculated date ranges 

if (re.getDdeNameO.index0f( M _slNCE M ) > -1) { 
String s = ""; 

if (fc.get(O) != null) 

s = Convert. getDateCalc(lnteger.parselnt((string) 

fc.get(O))); 

dbt . setUserNow(Convert . getCal endarFromSt ri ng (sessi on , 

hasNullCri teria ? "" : s)); 

re.setDdeDisplayType("DATE") ; 

// if --none — is the selected value 

if (hasNullCri teri a && criteriasize == 1) 

andProblem.append(" is null "); 
else if ("DATE".equalslgnoreCase(re.getDdeDisplayType())) { 


// do between 


if (criteriasize > 1 ) { 

andProblem.append(" between ? and ? "); 
paramsProblem.add(dbt .qetDbNowTimestampO) ; 
typesProblem.add("DATE ) ; 

params Probl em . add (dbt2 . getDbThenTi mestamp (1) ) ; 
typesProblem.add( M DATE"; ; 

} 

else { 

if (re. getDdeName().indexOf ("START") > -1 

| re.getDdeNameO .indexof ("_SINCE") > -1) { 
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anaProblem.append(" >= ? "); 
paramsProbl em . add(dbt . getDbNowTi mestampO) ; 
typesProblem. add ("DATE ) ; 

} 

else if (re.getDdeNameC) .indexOf ("STOP") > -1) { 
andProblem.append(" <= ? "); 
if (isTimeSeries) 
ti mese ri esDateParamPosi ti ons [0] = paramsProbl em . si ze () ; 

paramsProbl em . add (dbt . getDbThenTi mestampLessOneMi nuete (1) ) ; 

typesProblem.add("DATE") ; 

} 

else { 

andProblem.append(" between ? and ? "); 
paramsProbl em . add (dbt . getDbNowTi mestampO ) ; 
typesProblem. add("DATE*) ; 

paramsProbl em . add(dbt . getDbThenTi mestampLessOneMi nuete(l)) ; 

typesProblem. add("DATE") ; 

} } 

// This joins in the item to itemjiist to statusjiist 

// 

if (appendChartDate){ 

appendChartDate = false; 

// if (doHistJoin){ 

// andProblem,append(" and " + driverAlias + 

+ driverKey +" = sh. "+driverKey) ; 
// andProblem.append(" and " + tAlias + "." + 

driverKey + " = item_hist." + driverKey); 

// andProblem.append(" and " + tAlias + 

".timestamp = item_hist. timestamp "); 

// andProblem.append(" and item_hist ,change_type 

<> 'D' "); 

// doHistJoin = false; 

// } 

if (this.isStatusOnDate() || this.isStatusByDate()){ 

andProblem.append(" and " + re.getTAlias() + "." 
+ re.getDdeColumn() + " ") ; 

andProblem.append( ,? = "); 

andProblem.append(" (select MAX(x. timestamp) " + 
" from statusjiist x " + 
" where x.item_id = " + 

re.getDri verAlias() + " .item_id") ; 

// if (this.isStatusOnDate()){ 

// Track where the parameters that will be replaced in the timeseries loop 

// 

andProblem.append(" and trunc(x. timestamp) <= ? 

) "); 

if (isTimeSeries) 
ti meseri esDateParamPosi ti ons [1] = paramsProbl em . si ze () ; 

//{ 

// ti meseri esDates. put (new lnteger(paramsProblem.size()) , 
// dbt ); 

//} 
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paramsProblem.addCdbt . getDbThenTimestampLessOneMi nuete(l)) ; 

typesProblem.add("DATE M ) ; 

// } 

// else{ 

// andProblem.append( M and x. timestamp 

between ? and ? ) "); 

// 

paramsProbl em. add(dbt . getDbNowTimestampO) ; 

// typesProblem.add( M DATE") ; 

// 

paramsProblem.add(dbt2 .getDbThenTimestamp(l)) ; 

// typesProblem.add("DATE"); 

// } 

else if (isProductOrReleaseChart){ 

andProblem.append( M and not exists "); 
andProblem.append( M (select 1 " + 
" from status_hist x " + 
" where x.item_id = sh.item_id " + 
" and nvl (x. status, '-') <> 


nvl (sh. status, '-') " + 
and ? ) "); 


" and x. timestamp between sh. timestamp 


if (isTimeSeries) 
ti meSeri esDateParamPosi ti ons [1] = params Probl em . si ze () ; 

paramsProbl em. add (dbt.getDbThenTimestampLessoneMinuete(l)) ; 

typesProblem.add("DATE M ) ; 

I ^*********************** ******* * ******************************* 

// SPECIAL CASE FOR THE HISTORICAL STATUS BEING A FILTER 

// 

} // end if product or release chart 

// andProblem.append(" and " + driverAlias+" .item_id 

= sh.i tem_id " ) ; 

// andProbl em. append (" and " + dri verAlias+" . timestamp 

= sh.i tem_id " ) ; 

} // end if appendChartDate 
} // end if date is display type 

else { 

// build the string for multiple criteria values 

andProblem.append(" in ("); 

ArrayList areaToAdd = new ArrayListO; 

for (int k = 0; k < criteriasize; k++) { 
if (hasNullCriteria) { 

if ("{null}" .equalslgnoreCase((String) 

fc.get(k))) { 

skipcomma = true; 
continue; 

} 

} 

if (k > 0 && ! skipcomma) andProbl em. append(", ); 
skipcomma = false; 

if (docaselnsensi ti ve) 
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// include area in check 


fc.get(k)) != null)) { 
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else andProblem.append("?") ; 

if (re.getDdeNameO .equalsC'PROJECT") 

&& QProj ect . getAreaFromQual i f i edPro j ect ((St ri ng) 


areaToAdd.add(Project.getAreaFromQualifiedProject((String) fc.get(k))) ; 
paramsProbl em. add (Project . get Pro jectFromQual i f i edProject ((St ri ng) f c . get (k))) ; 

else { 

paramsProblem.add((String) fc.get(k)) ; 
typesProblem.add("STRING") ; 
andProblem.append( M ) ") ; // end in 

// qualified areas 

// 


".area_id in ( "); 


if (areaToAdd.size() > 0) { 

andProbl em. append (" and " + re.getTAliasQ + 


for (int k = 0; k < areaToAdd.size() ; k++){ 
if (k > 0) andProblem.appendC ") ; 
andProbl em. append ("?") ; 

paramsProbl em. add ((St ri nq)areaToAdd . get (k)) ; 
typesProblem.add("STRING*) ; 


} 


} 

andProbl em. append (") ") ; 


if (hasNullCri teria) andProbl em. append(" or " + 
cri teriaTableColumn + " is null )"); // end or is null 

} 


clause 


} 

/*********** *************************************** 

* Process non-problem table fields 

* (like problem_release or problem_module) then build an exists 


* To Do: Note that we currently only go one level out from the 

driver table so that the relationships are always to 
problem. problem_id — future changes may include a 
User Defined Table structure n levels deep 


* 
* 
* 

V 


else { 

Z. probe("RPT: Processing non-problem table field where 
ddeName is " + re.getDdeNameO + " ddeTable is + re.getDdeTable() + " and 
ddecolumn is " + re.getDdeCol umn() + " has null Criteria = " + hasNullCri teria) ; 


// determine the use of not exist clauses 

useNotExists = false; 

if (hasNullCriteria && criteriasi 
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if ( (re.getDdeTab1e().startsWith("PR0BLEM_RELEASE") 

I | re . getDdeTabl e () . startsWi th("lTEM_RELEASE") 

&& 

("RELEASE_FOUND". equal slgnoreCase (re. getDdeColumnO) 

IT 

"PRODUCT_NAME" .equal slgnoreCase(re. getDdeColumnO)) ) { 

useNotExists = true; 

else if ((re.getDdeTable().startsWith("PROBLEM_MODULE") 

| | re. getDdeTabl e(). startsWi th("ITEM_MODULE")) 
&& 

"MODULE_ID" . eq ual slgnoreCase ( re . getDdeCol umn () ) ) { 

useNotExists = true; 

} 

else if 

(re . getDdeTabl e() . startsWi th( M RELATIONSHIP_GROUP") 

&& 

"PARENT_ITEM_ID M .equal slgnoreCase(re. getDdeColumnO) 
M RELATI0NSHIP_GR0UP_ID M .equal slgnoreCase(re. getDdeColumnO)) { 

useNotExists = true; 

} 

} 

if (useNotExists && criteriasize > 1){ 

hashKey = re.getTAlias() + re. getDdeColumnO ; 
orExi sts . put (hashKey , hashKey) ; 

else hashKey = re.getTAlias() ; 

// 

// THIS IS A SPECIAL CASE FOR NON_NULLABLE FIELDS OF JOINED TABLES 

// 

// DO NOT EXIST 

// 

if (useNotExists) { 

if (notExistclauses. get (hashKey) == null) { 

notExists = new StringBufferO ; 
//if (criteriasize > 1) notExists.append( M or "); 
//else notExists. append(" and "); 

// skip this one for history -- there is no history table this far out 

if (re.getHasGrandParentTableO) { 

// not true for the RELATIONSHIP_GROUP_VIEW 

notExists. append(" not exists (select 1 from " + 


re.getTAlias() + 
re.getDdeParentKeyO + 
re.getDdeChi ldKeyO + 
re.getDdeGrandParentKeyO + 
re . getDdeGrandchi 1 dKey () ) ; 


" where " + re.getPtAliasO + "." + 
"= " + re.getTAliasO + "." + 
" and " + re.getGptAliasO + "." + 
"= M + re.getPtAliasO + "." + 
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re.getTAliasO + 
re.getDdeChildKeyO + 
re.getDdeParentKeyO) ; 
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else { 

notExists. append(" not exists (select 1 from 
" where " + re.getTAliasO + "." + 
"="■+ re.getDriverAliasO + "." + 


// if (this.hr) { 

// notExists. append(" and " + tAlias + "." + getHistKey(tAlias, false) + 
// + driverTable + "." + getHistKey(driverAlias, false)); 

// don't need the not null condition 
// because of the database constraint 

//} 

notExists. append (" and " + re.getTAliasO + ". 
re.getDdeColumn() + " is not null ") ; 

notExistClauses. put(hashKey, notExists) ; 

//z. probe (" CREATED NEW non_exist clauses :" + notExists); 

} 

} 


t! II 


// DO EXIST 

// 


DM 


else if (! useNotExists || (useNotExists && criteriasize 


if ((andExists = (Stri ngBuf f er) 
existClauses.get(hashKey)) == null) { 

andExists = new Stri ngBuf fer() ; 
paramsExists = new ArrayListO; 
typesExists = new ArrayListO; 

// skip this one for history — there is no history table this far out 

if (re.getHasGrandParentTableO) { 
// not true for the RELATIONSHIP_GROUP_VIEW 

andExists. append(" exists (select 1 from " + 

re.getTAliasO + ", " + 

re.getPtAlias() + " where " + 

re.getPtAlias() + "." + 

re.getDdeParentKeyO + " = " + 

re.getTAliasO + "." + re.getDdeChildKeyO + 

" and " + re.getGptAliasO + "." + 

re.getDdeGrandParentKeyO + 

"=" + re.getPtAlias() + "." + 

re . getDdeGrandChi 1 dKey ()) ; 

} 

else { 

andExists. append(" exists (select 1 from " + 

re.getTAliasO + 

" where " + re.getTAliasO + "." + 

re.getDdeChildKeyO + 

"=" + re.getPtAliasO + + 

re.getDdeParentKeyO) ; 
// if (this.hr) { 
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// andExi sts. append(" and " + tAlias + "." + getHistKey(tAlias, false) + 
// "=" + driverAlias +'■"." + getHistKey(driverAlias, false)); 

//} 

} 

} 

else{ 

if (andExists.toStringO .endswith(")")) 
andExi sts . setLength(andExi sts . 1 ength () -1) ; 

paramsExists = (ArrayList)existParams .get(hashKey) ; 
typesExists = (ArrayList)existTypes.get(hashKey) ; 

if (docaselnsensi tive && 
! "DATE" . equalslgnoreCase(re.getDdeDisplayType())) 

criteriaTab leColumn.append("UPPER("+ re.getTAlias() 

+ ■ + re.getDdeColumn()+")") ; . 

else 

criteriaTableColumn.append(re.getTAlias() + "." + 

re.getDdeColumnQ) ; 


luseNotExists) 

"): 


if (hasNull criteria && criteriasize > 1 && 


andExi sts. append(" and (" + cri teriaTableColumn + 


else 


andExi sts. append(" and " + cri teriaTableColumn ); 


if (hasNull criteria && criteriasize == 1){ 
andExi sts. append(" is null "); 

} 

else if 

("DATE" . equal slgnoreCase(re . getDdeDi spl ayType())) { 
// do between 

if (fc.sizeO > 1) { 

paramsExi sts . add (dbt . qetDbNow() ) ; 
typesExists.add("DATE n ) ; 

paramsExi sts. add (dbt2 .getDbThenTimestamp(l)) ; 

typesExi sts . add("DATE") ; 

andExi sts. append(" between ? and ? "); 

else { 

if (re. getDdeName() .indexof ("START") > -1) { 
andExi sts. append(" >= ? "); 
paramsExi sts . add(dbt . qetDbNowO) ; 
typesExi sts . add("DATE*) ; 

} 

else if (re. getTAli as (). indexof ("STOP") > -1) { 
andExi sts. append(" <= ? "); 

paramsExi sts. add(dbt.getDbThenTimestampLessOneMinuete(l)) ; 

typesExi sts . add("DATE") ; 

} 

else { 

andExi sts. append(" between ? and ? "); 

paramsExi sts . add (dbt . getDbThenTimestampLessOneMi nuete(l)) ; 

typesExi sts. add( f, DATE") ; 
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fc.get(k))) { 


andExi sts . append ("upper(?) ") ; 
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} 

} 

else { 

andExi sts. append(" in ( ") ; 


for (int k = 0; k < criteriasize; k++) { 
if (hasNull Criteria) { 

i f (" {nul 1 }" . equal slgnorecase ( (St ri ng) 

skipcomma = true; 
continue; 

} } 

if (k > 0 && ! skipcomma) andExi sts. append(", "); 

skipcomma = false; 

if (docaselnsensi ti ve) 


" is null )"); // end or is null 


else andExi sts. append("?") ; 
paramsExists . add((stri ng) fc.get(k)) ; 
typesExi sts . add("STRlNG ) ; 

andExi sts. append(") "); // end in 
if (hasNull Criteria) 

andExi sts. append( M or " + cri teriaTableColumn + 


// put the andExi sts clause back in the hashmap 
// put the paramsother list into the hashmap 

andExi sts. append(" )" ); 
exi stcl auses . put (hashKey , andExi sts) ; 
exi st Params . put (hashKey , paramsExi sts) ; 
exi stTypes . put (hashKey f typesExi sts) ; 
exi stAndOrs . put (hashKey , andor) ; 

//Z. probe("RPT:>»»exi stcl auses " + exi stcl auses) ; 
//Z.probe("RPT:»»>paramsExists " + paramsExists); 

//z. probe( M RPT:>»»notExi stcl auses " + notExi stcl auses) ; 

} // end process non-problem fields 
}// end wildcard/no wildcard 

}//END FILTER ITERATOR 

// Make sure that the STATUS_HIST table and ITEM_HIST table are included in 
// summary reports. These queries still join to status history 

//TO DO: create a report DDE object rather than hardcode 

// 

if (ischart){ 

if (distinctTables.get("sh") == null){ 
di sti nctTabl es . put ("sh" , thi sDDE) ; 

f romCnt++; 

jd . addAl 1 ("STATUS_HIST" , "sh M , jd . INNER_JOIN , "ITEM_ID" , M ITEM_HIST" , "ITEM_ID" p 1) ; 

} 

} 

/* if (isProductorReleaseChart){ 
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tAlias = oil .getTableAlias( M STATUS_HIST ,l ,"STATUS„HIST") ; 
if (distinctTables. get (tAlias) == null){ 

di sti nctTabl es . put (tAl i as , (DDEntry)f i 1 terFi el ds . get ("STATUS_HIST") ) ; 

//if (fromCnt++ > 0) f rom. append(", "); 

//from. append ( M STATUS_HIST *' + tAlias); 

i d . addAl T ( " STATUS_HIST" , tAl i as , " " , " " , 0) ; 

if (di sti nctTabl es. get ("ITEM_HIST") == null){ 

di sti nctTabl es . put( ITEM_HIST" , (DDEntry)f i 1 terFi el ds . get ("ITEM _hist") ) ; 
//if (fromCnt++ > 0) from.append(", "); 
//from. append ("item_hist "); 

id. addAl 1 ("item_hist" , getAl i as ("item_hist") , " " , " " , " *\ " " , 0) ; 
} 

V 

* Process problem table fields 

* for the FROM CLAUSE — includes aliases for the ordered index 

* To Do: Note that we currently only go one level out from the 

* driver table so that the relationships are always to 

* problem. problem_id — future changes may include a 

* User Defined Table structure n levels deep 

V 

String [] taa = oil .getTableAliasArrayO ; 
//Z. probe ("RPT : oil .getTableAliasArrayO = " +taa) ; 

// StringBuffer andPr = new stri ngBuffer() ; 

// Z.log.writeTol_og(Z.log.DEBUG3, "RPT: taa is: M + taa); 

if (taa != null && taa. length > 0) { 

for (int j = 0; j < taa. length; j++) { 
f romCnt++; 
if (j > 0){ 

//andPr.append(" and " + taa[j] + "." + problemKey + " = " + taa[j - 1] + ■ + 
problemKey) ; 

//if (fromCnt++ > 0) from. append (" , "); 
//f rom.append(driverTable + + taa[j]); 

j d . addAl 1 (t hi s . dri verTabl e , 
. taa[j] , 

j d . INNER_JOIN , 
PROBLEM_KEY, 

taa[j-l] f 

PROBLEM_KEY, 

0); 

} 

else{ 

j d . addAl 1 (thi s . dri verTabl e , 

taa[j], 


ii ii 
i 

ii H 

i 

ii M 
ii ii 


0); 

} 

// Z.log.wn'teToLogCz.log.DEBUG3, "RPT: - from append=" + dri verTable 

+ " " + taa[j]); 
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//andProbl em. append (andPr) ; 

d " 

/*(DDEntry)filter 

} 


di sti nctTabl es . put (re . getDri verAl i as () , 
Fields. get("lD* , )*/new DDEntryQ) ; 


// always include the driver table 

else { 

// if (fromCnt++ > 0) from. append (" , "); 

// f rom.append(driverTable + " + dri verAl i as) ; 

fromCnt++; 

jd . addAl 1 (thi s . dri verTabl e , 

re. getDri verAl i as () , 
M tt 

it ii 

i 

ii ii 
0)1 

Z.log.writeToLog(Z.log.DEBUG3, "RPT: * from append: 
this.driverTable + " " + re.getDriverAliasO) ; 


I? 


/*(DDEntry)filte 

} 


di sti nctTabl es . put (re . getDri verAl i as () , 
rFields.get( M lD*')*/new DDEntryO) ; 


// 

Z. log .wri teToLog (Z. log . DEBUG5 
select . toStringO : 11 +select. toStringO) 

Z . 1 og .wri teToLog (Z . 1 og . DEBUG5 
from. toStringO : " +from. tostri ngO) I 

Z. log. wri teToLog(Z. log . DEBUGS 
where. toStringO : " +where. tostn ng()) ; 

z. log .wri teToLog(z. log . DEBUGS 
andltemType. toStringO +andltemType) ; 

Z . 1 og .wri teToLog (z . 1 og . DEBUG5 
precondition. toStringO : " +preCondi tion) 

Z . 1 og .wri teToLog (Z . 1 og . DEBUGS 
andProblem. toStn ng() : " +andProblem) ; 

teToLog (Z . 1 og . DEBUG5 

+ andother) ; 
teToLog (z . 1 og . DEBUGS 
+ andUDF); 


"RPT 
"RPT 
"RPT 
"RPT 


ii 


Z. log. wri 
andother. tostri ng : " 

z. log. wri 
andUDF. tostri ng Q : " 

Z . 1 og . wri teToLog (Z . 1 og . DEBUGS 
andKeyword. tostn ng() : " +andKeyword) ; 

Z . 1 og . wri teToLog (Z . 1 og . DEBUGS 
andsortorder. toStringO : " +andSortOrder 

Z . 1 og . wn teToLog (Z . 1 og . DEBUG5 
orderBy. toStringO : " +orderBy); 

Z . 1 og . wri teToLog (Z . 1 og . DEBUGS 
groupBy. tostri ngO : " +groupBy);~ 


) 


RPT 
"RPT 
"RPT 
"RPT 
RPT 
"RPT 
"RPT 
"RPT 


n 


: before 

the 

sort 

--> 

: before 

the 

sort 

--> 

: before 

the 

sort 

--> 

: before 

the 

sort 

— > 

: before 

the 

sort 

— > 

: before 

the 

sort 

— > 

: before 

the 

sort 

— > 

: before 

the 

sort 

— > 

: before 

the 

sort 

--> 

: before 

the 

sort 

— > 

: before 

the 

sort 

— > 

: before 

the 

sort 

— > 


// 


y*************************** DOING SORT ORDER* *************************** 

* PROCESSING THE SORT 

# 


1. Fields that are multi valued are ignored - 
these should aready by filtered by the UI 

2. It is ASSUMED that sort orders will never 

contain PROBLEM_RELEASE and PROBLEM_MODULE 
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* tables at the same time. Therefore we do not need to 

* do a distinct select clause. Again thes should be 

* already filtered by the UI 

* Logic 

« 

* - Iterate through the sort order fields and use a distinctTables HashMap 

* to filter unique tables for creating the join. 

* - Process the UDF as aliases UDF tables & generate alias to then be used in 
the order_by 

* - Process any Lookups as special cases 

* 

HashMap ddeDisplayedDates = new HashMapQ; 

stringBuffer udflndexHint = new StringBufferO ; 
boolean anotherLookup = false; 
boolean doneFrom = false; 
string hasvaluesufx = "N" ; 


int origsofcnt = thisSo.getFields() .size() ; 

// add the calc fields for processing in the from clause 
// then remove them from the sort order 
HashMap calcDDNames = new HashMapO; 

if (this.calculatedFields.sizeO > 0) { 
doCalcFields = true; 
CalculatedField cField = null; 

for (int j = 0; i < this.calculatedFields.sizeO ; j++) { 

cField = (CalculatedField) this.calculatedFields.get(j) ; 

sof = new SortOrderField() ; 

sof . setDDName (cFi el d . getDDName () ) ; 

sof . setOrderRank(j + origsofcnt); 

cal cDDNames . put (cFi el d . getDDName () , " ") ; 

thisSo.getFields() . put(cField.getDDName() , sof) ; 


// THIS IS TO TEST WHETHER WE OUTER JOIN in the summary report 

// we need to do outer join for not null able fields in the join table 

// (ie count the number of null release found is an outer join 

// but to count the number of null release fixed /or release 

resol ution, 

// they need to be in a release to be counted) 


Iterator sofi = thisSo.getFields() .keySet() .iterator() ; 

//Z.log.writeToLog(Z.log.DEBUG5, "RPT: +++ thisSo.getFieldsO .keySetO 
+++ " + thisSo.getFieldsO .keySetO ); 

udfcnt = 0; 
sofcnt = 0; 

boolean i seal cField = false; 
String ojstr = ""; 
string ojStr2 = ""; 

String tempcolumnName = ""; 
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String tempDri verTable = "' ; 

if (ischart) tempDri verTable = "ITEM_HIST" ; 
else tempDri verTable = dri verTable; 

Z. probe("RPT: < sort order loop > the tempDri verTable is : " + 
tempDri verTable) ; 

Z.probe("RPT: < sort order loop > prSorts : " + prsorts) ; 

stringBuffer fromTable = new StringBufferQ ; 

while (sofi . hasNextQ) { 

sortorderinfo = new sortorderlnfo() ; 
key = (String) sofi. next (); 

z.log.writeToLog(Z.log.DEBUG5, "RPT: < sort order loop > for key 

" + key); 

if (calcDDNames.get(key) != null) isCalcField = true; 
else i seal cFi eld = false; 

sof = thisSo.getField(key) ; 

thisDDE = (DDEntry) (sortFields.get(key)) ; 

if (thisDDE == null) { 

Z.log.writeTol_ogCZ.log. DEBUGS, "RPTiALERT!!!!!!!!! COULD NOT 
FIND DDENTRY FOR : " + key + " in sortfields ") ; 

continue; 

} 

re = new ReportElement (thisDDE, oil, ischart, hr); 
re. toLog(z. log. DEBUGS) ; 

if (prsorts. get(re.getDdeNameO) != null && !isSummaryReport){ 
Z.log.writeToLog(Z.log.DEBUG5, "RPTiALERT! !!!!!!!! skipping 

SortOrder for DDEName (can't sort on releases) = " + re.getDdeNameO) ; 

continue; // skip releases... these get processed in the 

details - in getSelectQ method 

// filter by item_type 

// CURRENTLY -- WE ALWAYS INCLUDE ITEM TABLE WITH TYPE 0 

// . 

if (MsProblemltemTypeSet) { 

andItemType.append(" and " + re.getlTEM() + " . i tem_type_i d = ? 

") ; 

isProblemltemTypeSet = true; 
paramsltemType.add( ,, 0 M ) ; 
typesltemType.add("STRlNG") ; 

// DEBUG STUFF 

/* 

Z . 1 og . wri teToLog (Z.log. DEBUG5 , " 

") ; 

Z.log.writeToLog(Z.log.DEBUG5,"RPT -sort ordenddeType = " + 

re.getDdeTypeO) ; 

Z.log.writeToLog(Z.log.DEBUG5,"RPT sort order iddeDisplayType 

"+ re.getDdeDisplayTypeQ ); 

Z. log.writeToLog(Z.log.DEBUG5,"RPT sort order : ddeName = " 

+re.getDdeName()) ; 
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Z . 1 og . wri teToLog (Z . 1 og . DEBUG5 , "RP~P 
re.getDdeTableO) ; 

Z . 1 og . wri teToLog (Z . 1 og . DEBUG5 , "RPT- 
re.getDdeColumnO) ; 

Z. log. writeToLogCz.log. DEBUGS, M RPT sort order:ddeParentTable =" 

+ re. getDdeParentTableO) ; 

Z. log .wri teToLog(Z. log . DEBUGS , "RPT 
re . getDdeParentKey () ) ; 

z . 1 og . wri teToLog (Z . 1 og . DEBUG5 , "RPT< 
+re.getDdeChildKey() ); 

Z . 1 oq .wri teToLog (Z . 1 og . DEBUG5 , "RPT 
="+re.getDdeLookupTable()) ; 

Z . 1 og . wri teToLog (Z . 1 og . DEBUGS , "RPT- 
="+re. getDdeLookupTableO) ; 

Z . 1 og . wri teToLog (Z . 1 oq . DEBUGS , " RPT- 
order : ddeLookupCol umnl="+re . getDdeLookupCol umnlQ) ; 


z . 1 og . wri teToLog (Z . 1 oq . DEBUGS , "RPT* 
order : ddeLookupCol umn2="+re . getDdeLookupCol umn2 ()) ; 

z . 1 og . wri teToLog (Z . 1 oq . DEBUG5 , " RPT~ 
order : ddeLookupCol umn3="+re . getDdeLookupCol umn3()) ; 

*/ 

// DEBUG STUFF 


sort order iddeParentKey = 
sort order rddeChildKey =" 
sort order : ddeLookupTable 
sort order : ddeLookupKey 
sort 
sort 
sort 


/ /*** ***************** 1c*********************************** 

// * CREATING THE UDF JOINS 

// 


f romTable. set Length (0) ; 

i f ("UDF" . equal slgnorecase (re . getDdeType () ) ) { 

tableAlias = re . getDdeNameO ; //"UDF" + 
Stri ng . val ueof (udf Cnt++) ; 

//This was for before we used views 


IX_ITEM_UDFl")) ; 


\"ITEM_ID\", "); 


//■ 

//tableAlias = "IU_" + ddeName; 
//tableListAlias = "UL_" + ddeName; 
//tableudfAlias = "U_" + ddeName; 

di sti nctTabl es . put (tabl eAl i as , thi sDDE) ; 

udflndexHint .append(" " + Z. dbms . i ndexHi ntst ring (tableAlias, 

sortorde rlnf o . setTabl eAl i as (tabl eAl i as) ; 
//sortorderinf o . setTabl eLi stAl i as (tabl eLi stAl i as) ; 
sortorderlnfo. setsortorder Field (sof) ; 
sortOrderlnfo.setSortBy(tableAlias + ".VALUE"); 
sortorderlnfo. setSortByRawVal (tableAlias + ".VALUE"); 

f romTabl e . append(" (sel ect di sti net "+re . getlTEM_jJDF()+" . i tem^i d 
// need this for the bad_data problem 

if (this.hr){ 


f romTabl e.append(re.getITEM_UDF()+" . M +getHistKey(re.getITEM_UDF() , true) + " 

getHistKey(re.getlTEM() ,true)+", "); 

i f ( "LIST" . equal slgnorecase (re . getDdeDi spl ayType () ) 

"POPUP" . equal slgnorecase (re. getDdeDi sp layTypeO) 
"TAB" . equal slgnorecase (re . getDdeDi spl ayType ())) { 


it 
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fromTable. append (" udf_Jist. title TITLE, 
udf_list.udf_list_id VALUE, udf_list.sort_.seq SORT_SEQ " + 

" from udf, udf_list, "+re.getITEM_UDF() + 

" where udf.udf_id = "+re.getlTEM_UDF()+".udf_id "+ 

" and udf_list.udf_list_id = 
"+re.getITEM_UDF()+".udf_list_id " + 

" and udf. name = ? ) M )l 

sortOrderlnfo.setSortBy(tableAlias + ".TITLE"); 
sortOrderlnfo.setSortByRawVal (tableAlias + ".VALUE"); 


else if( "DATE".equalslgnoreCase(re.getDdeDisplayType()) ){ 

fromTable. append ( re.getITEM_UDF()+ ".value_date VALUE " + 
" from udf, "+re.getlTEM_UDF()+ 

" where udf.udf_id = "+re.getITEM_UDF()+" . udf_id " + 
" and udf. name = ? ) " ); 

else if( "NUMBER". equal slgnoreCase(re.getDdeDisplayType()) ){ 
fromTable. append( re.getrrEM_UDF()+" . value_number VALUE " + 
" from udf, "+re.getITEM_UDF()+ 

" where udf.udf_id = "+re.getlTEM_UDF()+".udf_id " + 
" and udf. name = ? ) " ); 

else if ("USER" . equal slgnoreCase(re . getDdeDi spl ayType())) { 
sortorderlnf o . setSortBy( 
thi s . getFormattedNameForQuery (tab! eAl i as , 

"securi ty_user_id" , 
"fi rst_name" , 
"last_name") ); 

fromTable. append( 

re.getlTEM_UDF()+ ".value VALUE, " + 

"su.fi rst_name FIRST_NAME, su.last_name LAST_NAME , " 

+ 

" su. securi ty_user_id SECURITY_USER_ID " + 
" from securi ty_user su, udf, "+re.getiTEM_UDF()+ 
" where udf.udf_id = "+re.getITEM_UDF()+".udf_id " + 
" and su. securi ty_user_id = " + re.getlTEM_UDF() + 

".value "+ 

" and udf. name =?)"); 

} 

else{ 

fromTable. append( re.getlTEM_UDF()+ " .value VALUE " + 
" from udf, "+re.getlTEM_UDF()+ 

" where udf.udf_id = "+re.getlTEM_UDF()+".udf_id " + 
" and udf. name = ? ) "); 

} 

paramssortorder . add(re.getDdeName()) ; 
typesSortOrder.add("STRING") ; 

// join in the UDF from table 

//.i 

f romCnt++; 

jd.addAll (f romTable. tost ring () , 

tableAlias, 

jd.LEFT_DOIN, 
DRIVER_KEY, 
re.getDriverAlias() , 

DRIVER_KEY, 
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i); 


if (this.hr) { 

andSortOrder.append(" and " +tableAlias+ "." + 
getHi stKey (tabl eAl i as , t rue) + 

Z.dbms.ojequalsO + driverTable +"."+ 

getHi stKey (dri verTabl e , f al se)) ; 


soFi el ds . put (St ri ng . val ueOf (sof . getOrderRankO) , sortorderlnf o) ; 


} 


* CREATING NON-UDF JOINS 

* 

* 

* NOTE: I only go ONE table out. Cannot sort on a MULTIPLE field 

* The sort fields that are more than one table out from the driver 

table are ignored 

* for this reason 

* Oct 2002 going to sort on child fields within the getSelect() 

method . . . 

* I will pass on the stored sort orders for the multiple children 

* and process them accordingly within each one (currently I hard 
code the sort on release_timestamp) 

* If the field is a lookup, then process the logic for this as 


well . 


* 

**************************** 


useOJRelease; 
useOJModule; 


else if (TextManager.isStringVisible(re.getDdeTableO)) { 

useOD = false; 

ojstr = Z.dbms.ojequalsO; 

if ( re . getDdeTabl e() . startsWi th("PROBLEM_RELEASE")) useOJ = 
else if ( re.getDdeTable().startsWith( M PROBLEM_MODULE M )) useOJ = 


else if ( re. getDdeTabl e() .startsWi th("RELATlONSHIP_GROUP")) 
useOJ = useOJRelationshipGroup; 

ojstr = useOJ ? Z.dbms.ojequalsO : " = "; 
ojStr2 = useOJ ? jd.LEFT_30IN : jd.INNER_JOIN; 

tempobject = distinctTables.get(re.getTAlias()) ; 
if (tempobject != null){ 

tempColumnName = ((DDEntry) tempobject) .getColumnName() ; 

if (tempColumnName == null) tempColumnName = ""; 

else tempColumnName = TextManager. replace (tempColumnName, 

"II", z.dbms.catO); 

} 

// Join in new table 

// don't join in tables if it is a chart -- the sorted fields 

are 

// selected from the multi -select box as filters — thus, the 

from clause is built 
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if (i sProductOrReleaseChart){ 
tableAlias = re.getTAlias() ; 

else if ( tempObject == null ) { 

// create the joins (here we only go 1 or 2 tables OUT) 

// 

if 

(tempDri verTable . equal slgnoreCase( re. getDde ParentTabl e())) { 

if (this.hr){ 

andSortOrder.append(re.getTAlias() + "." + 
getHistKey(re.getDdeTable() , false) + 

ojstr + re.getPtAlias() + "." + 

getHistKey(re.getDdeTable() , false)) ; 

} 

f romCnt++; 

jd.addAll (re. getDdeTableO , 

re.getTAlias() , 
ojStr2, 

re . getDdeChi 1 dKey () , 
re.getPtAlias() , 
re.getDdeParentKeyO , 

1); 

} 

// not for history - doesn't go that far out 
// this doesn't happen for the view 

// 

else if (re.getHasGrandParentTableO) { 

jd.addAll (re.getDdeTableO , 

re.getTAliasQ , 
ojStr2 , 

re . getDdeChi 1 dKey () , 
re.getPtAlias() , 
re.getDdeParentKeyO , 

1) ; 

jd.addAll (re.getDdeParentTable() , 

re.getPtAlias() , 
ojStr2 , 

re . getDdeGrandchi 1 dKey () , 
re.getDdeGrandParentTableC) , 
re.getDdeGrandParentKeyO , 

2) ; 

distinctTables. put(re.getPtAlias() , thisDDE) ; 

else if (tempDriverTable.equalslgnoreCase(re.getTAlias())) { 
f romCnt++; 

j d . addAl 1 (tempDri ve rTabl e , 

re.getTAlias() , 


if ii 
ii M 

i 
i 
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} o)i 

tableAlias = re.getTAlias() ; // returns driverAlias if none 

found 

} 

// If the join is on the same field/ exisiting table, then we 
need to alias the table 

// but not a calculation on the same field (ie assigned_to / 

originator / owner 


// 


else if (re. getDdeColumn() .equal slgnoreCase( tempColumnName ) 
&& 

TextManager . i sSt ri nglnvi si bl e ( re . getDdeLookupCol umnl() ) ) { 

tableAliasCnt++; 

tableAlias = re.getTAlias() + "_" + 
St ri ng . val ueOf (tabl eAl i asCnt) ; 

// Create the joins (here we only go 1 or 2 tables out) 

// 1 

if 

(tempDriverTable. equal slgnoreCase(re.getDdeParentTable())) { 


if (this.hr){ 

andSortOrder.append(tableAlias + "." + 

getHistKey(tableAlias, true) + 

oistr + re.getPtAliasO + "." + 
getHistKey(re.getDdeParentTable() , false)) ; 


f romCnt++; 

jd.addAll (re.getDdeTable() , 

tableAlias, 
ojStr2, 

re . getDdeChi 1 dKey () , 

re.getPtAliasO , 

re . getDdeParentKey () , 

i); 

} 

// don't have any history tables this far out 
// don't worry about this with views 
else if (re.getHasGrandParentTableO) { 

jd.addAll (re.getDdeTableO , 

tableAlias , 
ojStr2, 

re . getDdeChi 1 dKey () , 

re.getPtAliasO , 

re. getDdeParentKey () , 

1); 

jd.addAll (re.getDdeParentTable() , 

re.getPtAliasO , 
ojstr2 , 

re . getDdeGrandChi 1 dKey () , 
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re.getGptAliasO , 
re . getDdeGrandParentKey () , 

} 

else if (tempDriverTable.equalslgnoreCase(re.getTAlias())) { 
f romCnt++; 

jd.addAll (tempDriverTable, 

re.getTAlias() , 

it 
it ti 
it ii 

0) 
} 

else { 

tableAlias = re.getTAliasQ ; 
di sti nctTabl es . put (tabl eAl i as , thi sDDE) ; 
sortorderlnfo . setSortOrderField(sof) ; 
// Lookup is a calculation 

if ((TextManager . i sStri ngVisible(re.getDdeLookupColumnlQ)) 

&& (TextManager. isstringlnvi si ble(re.getDdeLookupKeyO))) { 

sortorderlnfo. setTableAlias("") ; // table/alias of sorted 

field 

sortorderlnfo . setSortBy (TextManager . repl ace (re . getDdeLookupCol umnlQ , 


p. , 

re.getDri verAlias() + ".")); 

sortorderlnfo . setSortByRawval (TextManager . repl ace(re . getDdeLookupCol umnl() , 
re.getDriverAliasO + "■")); 

// Lookup is a Lookup 

else if (TextManager. isstringVisible(re.getDdeLookupKey())) { 
anotherLookup = false; 

sortorderlnfo. setSortByRawval (re.getDdeLookupKeyO) ; 

// the table's there in distinct tables as the ddeTable, 
// but the lookup is in the same table (ie ddeTable == 

// so don't add it to the from and do not alias it, just 


ddeLookupTable) 
bring data back 

// 


if 

(re . getDdeTabl e () . equal slgnoreCase(re . getDdeLookupTabl e ()) 

I I 

TextManager . i sst ri nglnvi si bl e(re . getDdeLookupTabl e()) ) { 
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luTableAlias = re.getDdeLookupTableO; 

} 

// Join in new lookup table TO DO: LOOKUPS ON 

RELATIONSHIP GROUP 

// 

else if ((tempObiect = 
distinctTables .get(re.getDdeLookupTab leQ)) == null) { 

luTableAlias = re.getDdeLookupTableO ; 
anotherLookup = true; 

} 

// If the join is on the same field/ exisiting table, then 
we need to alias the table 


// 


else if 

(re.getDdeLookupCol umnl() . equal slqnoreCase(((DDEntry) 
tempob j ect) . getLookupCol umnl() ) ) { 

tabl eAl iascnt++; 

luTableAlias = re.getDdeLookupTableO + "_" + 
St ri ng . val ueof (tabl eAl i asCnt) ; 

Z.log.writeToLog(Z.log.DEBUG3, M RPT:from append hererif 
the join is on the same field 1 '); 

anotherLookup = true; 

} 

if (anotherLookup) { 

di s ti nctTabl es . put (1 uTabl eAl i as , thi sDDE) ; 

// doing lookup - 0/1 tables out -- already 

if (re . getDdeTabl e() . equal slgnoreCase(tempDri verTabl e) 

re . getDdeParentTabl e () . equal slgno reCase (tempDri verTabl e) 

| | (ischart!) ) { 

f romCnt++; 

jd.addAll (re.getDdeLookupTableO , 
luTableAlias, 

jd . LEFT_JOIN , 

re . getDdeLookupKey () , 

("ITEM". equal slgnoreCase (re. getDdeTabl e())) 
? re.getDriverAlias() : tabl eAl i as , 
re.getDdeColumn() , 
1); 

} 


sorted field 


} 

sortOrderlnfo.setTableAlias(luTableAlias) ; // table name of 


// The column you sort on is a regular lookup or else a USER 
lookup - a user lookup is a concatenation 

if ("USER" . equalslgnoreCase(re.getDdeDisplayType())) { 
sortOrderlnfo.setsortBy( 
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thi s . getFormattedNameForQuery (1 uTabl eAl i as , 


re . getDdeLookupKey () , 

Mi 


re . getDdeLookupCo I umnl() , 
re.getDdeLookupColumn2()) ); 

} 

else { 

sortorderlnf o . setSortBy (re . getDdeLookupCo! umnl() ) i 

} 

} 

// Not a Lookup 
else { 

sortOrderlnfo.setTableAlias(tableAlias) ; // table 
name/alias of sorted field 

sortorderlnfo. setSortBy( re. getDdeCol umn()) ; 
sortorderlnfo. setSortByRawVal (re.getDdeColumn()) ; 

//Z.probe(" ADDING sort ORDER to soFields " + sof .getDDNameO + 
+sortOrderlnfo[0]) ; 

soFi el ds . put (stri ng . val ueof (sof . getOrderRankO) , sortorderlnfo) ; 

} // end if lookup not null 
} // end while sofi hasNext() 

// All ways include the problem table 

// 

if ((tempobject = distinctTables.get(re.getDriverAlias())) == null) { 
f romCnt++; 

jd . addAl 1 (tempDri verTabl e , 

re.getTAliasQ , 
it ii 

ii ii 

ii ii 

ii ii 

o)! 

distinctTables. put(re.getDriverAlias() , 
(DDEntry)filterFields.get(re.getDriverAlias())) ; 

} 

// remove the calcFields from the Sort Order object - processing done 

if (doCalcFields) { 

Iterator cdi = calcDDNames. keyset () .iterator () ; 

while (cdi . hasNextO) 

thisSo.getFieldsQ . remove(cdi ,next()) ; 


// Build the from clause 


// 


j d . toLog (z . 1 og . DEBUGS) ; 
String[] s = Z.dbms.buildFromClause(jd) ; 

z . probe ( M @@@@@@@@@(a(a@(a(a@@ Que ryBui 1 der . bui 1 dFromcl ause (j d) [0] from 
clause : "+ s[0]); 

z.probe("@@@@@@(a(a(a(a(a(a(a(a(a@ Que ryBui 1 der. bui 1 dFromcl ause (jd) [1] WHERE 
clause : "+ s[l]); 
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f rom. append (s[0]) ; 
andsortorder . append(s [1] ) ; 


^******** ****************************** 

* BUILD THE ORDER BY CLAUSE 

* 

* get from the soFields TreeMap sequentially using the key (this is a 

rank) 

* to retrieve SortOrderlnfo 

V 

string fieldAlias = ""; 

String sortByRawVal = ""; 

String rawval Select = 11 "; 

String rawValGroupBy = ""; 

SortOrderlnfo soflnfo = null; 

stringBuffer sortselect = new stringBuffer() ; 

orderBy.append(" ORDER BY ") ; 

boolean skipsort = false; 

Iterator iter = soFields. keySetO .iterator() ; 
while (i ter . hasNext()) { 

String keyValue = (String) iter. next (); 

soflnfo = (SortOrderlnfo) soFi elds. get (keyVal ue) ; 

temp = soflnfo.getTableAliasQ ; // the table alias 

sof = soflnfo. getSortOrderField() ; // the sortOrderField 
fieldAlias = sof .getDDNameQ ; 


// don't add calculated fields to the select or group_by or order_by 
if (doCalcFields) { 

if (calcDDNames .get (fieldAlias) != null) { 
skipsort = true; 

//Z.probe("skipping group_by/ orderby processing for " + 

fieldAlias) ; 

//Z. probe (" going to continue;"); 
continue; 

} 

} 

thisDDE = (DDEntry) sortFi elds. get (fieldAlias) ; 
tmpDisplayType = thisDDE.getDisplayTypeQ ; 
tmpType = tnisDDE.getType() ; 
tmpName = thisDDE.getNameO ; 

//Z.probe("Doing group by order by for dde " + fieldAlias); 

if (! keyValue. equals ((St ring) soFields.fi rstKeyO) && ! skipsort) { 

orderBy . append(" , "); 

skipsort = false; 

if (this.isSummaryReportO && ! skipsort) { 

if (! keyValue. equals((Stri ng) soFields.fi rstKeyO)) { 
groupBy . append(" , ") ; 
gSelect.append(", ") ; 

skipsort = false; 
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} 

if ("" .equalslgnoreCase(temp)) { 
sortBy = soflnfo.qetSortByO ; 
sortByRawVal = soflnfo.getSortByRawVal () ; 

else { 



sortBy = 


soflnfo.getSortByO ; 

sortByRawVal = soflnfo.getSortByRawVal () ; 
} 

else if ( ,, USER ,, .equalslgnoreCase(tmpDisplayType)) 

sortBy = soflnfo.getSortByO; 
else{ 

sortBy = soflnfo.getSortByO; 
sortByRawVal = soflnfo.getSortByRawVal () ; 

} 


} 

else { 


the lookup section 


sof Inf o . getSortBy O 


// Special case for users/ dates alias already done in 

i f ("USER" . equal slqnorecase (tmpDi spl ayType) ) 

sortBy = soflnfo.getSortByO; 
else{ 

if (Z. dictionary. hasOrderRank(tmpName)) 

sortBy = temp + " . sort„seq, + temp + "." + 


valuesufx + 


"D" 


else 

sortBy = temp +. "." + soflnfo.getSortByO; 

i f ("DATE" . equal slgnoreCase (tmpDi spl ayType) ) 

sortByRawVal = temp + . + soflnfo.getSortByO; 

el se 

sortByRawVal = temp + "." + soflnfo.getSortByRawVal () ; 

} 

} 

orderBy.append(sortBy + " " + sof .getSortDi rectionO) ; 
if (this.isSummaryReportQ) { 

if (TextManaqer.isStringVisible(soflnfo.getSortByRawVal ())) { 
rawval Select = ", " + sortByRawVal + " " + fieldAlias + 

rawValGroupBy = " + sortByRawVal + " "; 

if ("DATE".equalslgnoreCase(tmpDisplayType)) hasvaluesufx = 

else hasvaluesufx = "Y"; 

} 

else { 

rawval Select = ""; 
rawValGroupBy = ""; 
hasvaluesufx = "N"; 

groupBy.append(sortBy + rawValGroupBy); 

gSelect.append(sortBy + " " + fieldAlias + rawVal Select) ; 
g roupByAl i ases . put (f i el dAl i as , hasval uesuf x) ; 
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if ("DATE". equal s(tmpDisplayType)) 
ddeDi s pi ayedDates . put (f i el dAl i as , " ") ; 

else if (addReleasesql){ 

sortSelect.appendC", " + sortBy /*+ " " + fieldAlias + 

rawval Select*/) ; 

} 

Z.log.writeToLog(Z.log.DEBUG5," DONE THE SORT ORDER LOGIC" ); 

* PROCESS THE QUERY TO GET A LIST OF IDS 

* 1) build query from constituent parts computed above 

* 2) bind params 

* 3) execute 

V 

int gbsize = 0; 

String hintstring = Z.dbms .getorderedHintString(oil .getlndexHintArrayO) 
+ udflndexHint. toStringO ; 

String iHint = Z.dbms.getHint (hintstring) ; 

select . append("select "); 
select .append (iHint) ; 
select .append(" ") ; 

re = new ReportEl ement(nul 1 ,oil ,isChart, hr); 
re. toLog(Z. log.DEBUG5) ; 

if (this.isSummaryReportO) { 

gbsize = groupByAliases.size() ; 

if (IdoCalcFields) { 

// if (this.hr) { 

// select . append(" count(" + 
/^'distinct"*/ "*) "); 

// select . append(" count("); 

// select . append(driverAlias) ; 

// sel ect . append (" . ") ; 

// select . append (drive rKey) ; 

// select .append(") "); 

// select ,append(idCountAli as) ; 

// } 

// else { 

select. append(" count ( distinct ") ; 

sel ect . append (re . getDri verAl i as () ) ; 

select. append(" . "); 

select. append (DRIVER_KEY) ; 

select. append(") ") ; 

sel ect . append (i dCountAl i as) ; 

// } 

} 

else { 

CalculatedField cField = null; 

stringBuffer tempAlias = new stri ngBufferO ; 

for (int k = 0; k < this.calculatedFields.sizeO ; k++) { 
if (k > 0) select.append(", "); 

cField = (CalculatedField) this.calculatedFields.get(k) ; 
tempAlias.setLength(O) ; 
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tempAl i as . append (cFi el d . getDDName () ) ; 
tempAli as. append ("_") ; 

tempAl i as . append (cFi el d . getcal cul ati on () ) ; 
groupByAl i ases . put (tempAl i as . tostri ng() , "CALC") ; 

sel ect . append (cFi el d . getcal cul ati on()) ; 
select .append("(") ; 

if (lthis.hr) select. append("disti net "); 
sel ect . append (cFi el d . getDDName () ) ; 
sel ect. append(". VALUE) "); 
sel ect . append (tempAl i as) ; 

} } 

select. append(" , "); 

sel ect . append (gsel ect . tost ri ng () ) ; 

else { 

select. append( M "); 

if (isRe leaseltemTypeSet) select . append( M DISTINCT ") ; 
sel ect . append (re . getDri verAl i as () ) ; 
select .append( M . ") ; 

select. append (DRIVER_KEY) ; // we only ever get back list of problem 
if (addReleaseSql) select. append(sortSelect. toStringO) ; 

// if (this.hr) { 

// select. append(" ") ; 

// select. append (driverAli as) ; 

// select. append(" . ") ; 

// select. append(getHistKey(driverTable, false)) ; 

} . 

// Build the query string 

// 


// First process the not exists clauses / criteria for each child table 


11 it 


String tempKey = 
Iterator neclterator = notExistClauses. keyset () .iterator () ; 
ArrayList nullParams = new Arrayl_ist() ; 
StringBuffer andNotExists = new Stri ngBuf f er() ; 
String ddeTabl eCol umn = "" ; 
ArrayList tempList = null; 
andExists = new stri ngBuf f er () ; 
andother = new stri ngBuf fer() ; 

EaramsOther = new ArrayListO; 
oolean doOrExists = false; 

whi 1 e (neclterator . hasNext () ) { 

tempKey = (string)neclterator.next() ; 
andExists = (StringBuffer) exi stclauses. get (tempKey) ; 
andNotExists = (StringBuffer) notExi stclauses. get (tempKey) ; 
if (andExists != null){ 

doOrExists = orExists. get (tempKey) != null; 

if (andNotExists != null){ 

andother . append ((stri ng)exi stAndOrs . get (tempKey)) ; 
if (doOrExists) andother .append(" ( ); 

andother . append(andNotExists) ; 
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} 


if (doOrExists){ 

andother .append(" or "); 
andother .append( andExists ); 
andother. append(" ) ") ; 


if ( ( tempList = (ArrayList)existParams.get(tempKey) ) != null 
) paramsother. addAl 1 (tempList) ; 

if ( ( tempList = (ArrayList)existTypes.get(tempKey)) != null) 
typesOther . addAl 1 (tempLi st) ; 

existclauses. remove (tempKey) ; // this wont get processed again 

as an exist 

} 

else if (andNotExi sts != null){ 

andothe r . append ( (St ri ng) exi stAndOrs . get (tempKey) ) ; 
andother . append(andl\lotExi sts) ; 

} } 

// Then process the exists clauses / criteria for each 
// child table (but leave out the is null ones) 


//■ 

Iterator eclterator = existclauses. keySet() .iterator() ; 
whi le (eclterator . hasNext()){ 

tempKey = (string)eclterator . next() ; 

andExists = (Stn ngBuffer) exi stclauses. get (tempKey) ; 

if (andExists != null){ 

andother . append((Stri ng)exi stAndOrs . get (tempKey)) ; 
andother . append( andExists ); 

if ( ( tempList = (ArrayList)existParams .get (tempKey) ) 
) paramsother . addAl 1 (tempLi st) ; 

if ( ( tempList = (ArrayList)existTypes. get (tempKey)) ! 
typesOther . addAl 1 (tempLi st) ; 

} } 


!= null 
null) 


// Build 

// 

// 
Z 

z 
z 
z 
z 
z 
z 
z 
z 
z 
z 
z 
z 

// 
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"ABOUT TO buildQueryString 
"select. toStringO + sele 

i\ r . — . ■ /"\ it . r j_ 


it 


); 


"f rom. toStringO 
"where . tostri ng() 


ect. toStringO ); 


+ from. toStringO) ; 

"+ where. tostringQ) ; 
"precondition. toStringO "+ precondition. toStringO) ; 
"andltemType. toStringO "+ andltemType. tostri ng()) ; 
"andProblem. toStringO "+ andProblem. toString(j) ; 

"+ andother. toStringO) ; 
andUDF. toStringO) ; 


"andother . tostri ng () 
"andUDF. tostri ng() "+ 

"andKeyword. toStringO "+ andKeyword. toStringO) ; 
"andsortorder. tostri ng() "+andSortOrder . toStringO ); 
"orderBy. toStringO "+ orderBy. toStringO) ; 
"groupBy. tostri ng() "+ groupBy. tostri ng()) ; 


DEBUG STUFF 


// 


query = bui 1 dQueryStri ng(select. toStringO , 

f rom. tostri ng(; , 
where. tostri ng() , 
preCondi ti on . tost ri ng () , 
andltemType. toStringO , 
andProblem. toStringO » 
andother . tost ri ng () , 
andUDF. tostri ng(; , 
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andKeyword. tost ring () , 
andsortorder .toStringO , 
/*(isReleaseltemTypeSet) ? M " :*/ 

orderBy. tost ring () , 

groupBy. tost ring ()) ; 

z.log.writeToi_og(z.log.DEBUG5, "rptilist query is :"■+ query); 

// if (isReleaseltemTypeSet) query += " ) order by iterruid;" ; 

statement = conn. prepareStatement (query) ; 

String inSumQuery = ""; 

string sumAttachSi zeQuery = "" ; 

if (doAttachAlert) { 

inSumQuery = buildQueryString (select. toStringO , 
from. tost ri ngO , 
where. toStringO , 
preCondi ti on . tost ri ng () , 
andltemType . tost ri ng () , 
andProbl em . tostri ng () , 
andothe r . tost ri ng Q , 
andUDF . tost ri ng Q , 
andKeyword. toStringO , 
andsortorder. tostri ng() , 


I? n 


it it 


); 


sumAttachSi zeQuery = "select sum(a.file__size) " + 

" from attachment a where a.item_id in ( " + 
inSumQuery + 


Z. log. writeToLog(Z. log. DEBUGS, "RPT: sumAttachSi zeQuery = " + 
sumAttachSi zeQuery) ; 

sumAttachStatement = conn. prepareStatement (sumAttachSi zeQuery) ; 

} 

else if (isNewPersist && ! this.isSummaryReportO) { 

countQuery = buildQueryString( M select " + iHint + " count( DISTINCT 
"+ re.getDriverAlias() +".ITEM_ID ) 

from. tostri ng() , 
where . tostri ng() , 
precondition. toStringO , 
andltemType . tostri ng () , 
andProbl em . tost ri ng () , 
andother . tostri ng() , 
andUDF . toStri ng Q , 
andKeyword. toStringO i 
andsortorder. tostn ng() , 


it it 


groupBy. toStringO) ; 

countstatement = conn . prepareStatement(countQuery) ; 

z. log. writeToLog(z. log. DEBUGS, "RPT: count query is :" + 

countQuery) ; 

} 

java. sql .Timestamp tempTimestamp = null; 

params . addAl 1 (paramsSortOrder) ; 
params . addAl 1 (paramsPreCondi tion) ; 

int timeSeriesDateParamPositionOffset = params. size() ; 
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params . addAl 1 (paramsltemType) ; 
params . addAl 1 (paramsProbl em) ; 
params . addAl 1 (paramsother) ; 
params . addAl 1 (paramsUDF) ; 
params . addAl 1 (paramsKeyword) ; 


types . addAl 1 (typessortorder) ; 
types . addAl 1 (typesPreCondi ti on) ; 
types . addAl 1 (typesltemType) ; 
types . addAl 1 (typesProbl em) ; 
types . addAl 1 (typesother) ; 
types . addAl 1 (typesUDF) ; 
types . addAl 1 (typesKeyword) ; 

if (isTimeSeries){ 

int timeSeriesDayCnt = 1 ; 
Iterator i t = nul 1 ; 
Integer tmplnt = null; 


ArrayList slices = DbTime.getTimestampsBetweenStartStopLimits( 
dbtForTimeSeries.getDbThenTimestampLessOneMi nuete(l) , 

dbt2 .getDbThenTimestampLessOneMi nuete(l) , 
this.getTimeinterval ()) ; 

Timestamp currentslice = dbt .getDbNowTimestampO ; 

for (int w =0; w < (slices. si ze()) ; w++){ 

currentslice = (Ti mes tamp) si ices. get (w) ; 
//Z.probe("CURRENT SLICE = " + currentslice); 

// Combine parameters 

// . 

// Replace the param values for the timeseries Dates 

// 

for (int j = 0; j < timeSeriesDateParamPositions. length; j++) 
params . set (ti meSeri esDateParamPosi ti onOf f set + 
timeSeriesDateParamPositions [j] , 

currentslice) ; 

// Bind the params 

// 

string bindType = ""; 

Z.log.writeTol_og(Z. log. DEBUG, "RPT: params : " + params); 
Z.log.writeToLog(Z. log. DEBUG, "RPT: types : " + types); 

statement = this.bindParams (params, types, statement); 

if (doAttachAlert) 

sumAttachStatement = thi s . bi ndParams (params , 
types , sumAttachStatement) ; 

else if (isNewPersist && ! this.isSummaryReportO) 

countstatement = this.bindParams (params, 

types , countstatement) ; 

- 

// Get the result set 

// 

Resultset result = statement . executeQueryO ; 
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// SUMMARY REPORT RESULT SET 

// 

if (this.isSummaryReportO) { 


whi le (resul t . next()) { 
rows = new HashMapQ; 


/* Retrieve Data for each sort field 

*/ 

//z.probe("soFields.size == " + soFields.sizeO) ; 

//Z. probe( M groupByAliases.size=" + groupByAliases.sizeO) ; 

//z. probe("soFields== " + soFields); 

//Z. probe( M groupByAliases=" + groupByAliases) ; 


Iterator gbi = groupByAl iases. keyset () .iterator () ; 
int k = 0; 

rows . put ("TIMESTAMP" , thi s . f ormatDateStri ng (dbt , 
su, 

Convert . toCal endar (cur rentsl i ce) , 
emptystri ngspacer)) ; 

while (gbi . hasNextO) { 

alias = (string) gbi. next (); 


/* Deal with dates 


/ 


if (ddeDisplayedDates. get (alias) != null) { 
//temp = resul t.getst ring (alias) ; 

tempTimestamp = result .getTimestamp(alias) ; 
if (TextManager.isStringVisible(temp)) { 
temp = formatDateString(dbt, 
su, 

//convert . getCal endar FromStri ng (sessi on , temp) , 

Convert . toCal endar (tempTi mes tamp) p 
emptystri ngspacer) ; 

} else temp = 

thi s. get PrintableResult (resul t.getst ring (alias)) ; 

rows. put (alias, 

TextManager . i sst ri nglnvi si bl e (temp) 

? "CALC" . equal s (g roupByAl i ases . get (al i as)) 

? "0" : emptystri ngspacer 

: temp) ; 

/* Deal with values & dates 


*/ 

if ("D".equals(groupByAliases.get(alias))) { 
tempTimestamp = resul t.getTimestamp(ali as + 
valuesufx); // this was getStringO 
// Convert. toCal endar (tempTimestamp) ; 

if (TextManager. isStringVi si ble(temp)) { 
temp = formatDateString(dbt, 
su, 

convert . toCalendar(tempTimestamp) , 
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//Convert .getCal endarFromSt ring (session, resul t .getstring (alias + valueSufx)) , 

emptystn ngSpacer) ; 
rows. put (a lias + valueSufx, temp); 

else if ( M Y".equals(groupByAliases.get(alias))) { 
temp = result. getstring (alias + valueSufx); 
rows. put (alias + valueSufx, temp); 

} 

} 

if (this.calculatedFields.size() == 0) 
rows . put (i dCountAl i as , 
resul t.getstri ng(idCountAlias)) ; // the count 

resul ts.add(rows) ; 
} // end while 
}// end if summary report 
} // end while 
} // end if timeseries 
else{ // not a timeseries 

* 

/* Bind the params 

*/ 

String bindType = ""; 

z.log.writeToLog(z. log. debug, "RPT: params : " + params); 
Z.log.writeToi_og(Z. log. DEBUG, "RPT: types : " + types); 

statement = this.bindParams (params, types, statement); 
if (doAttachAlert) 

sumAttachStatement = this.bindParams (params, 
types , sumAttachStatement) ; 

else if (isNewPersist && !this.isSummaryReport()) 

countstatement = this.bindParams(params, types , countstatement) ; 

/* Get the result set 

*/ 

Resul tSet result = statement . executeQueryO ; 
int rsRownum = 0; 

// currently the largest blocksize is 5000 « 10 pgs * 500 results per page 

int TastBlockSize = 0; 
int currentBlocksize = 0; 

// limited results per page 

if (! unlimi tedResul ts) { 

if (this.pageBlock > 1 && retrievecount > 0) 

TastBlockSize = (this.pageBlock - 1) * retrievecount; 

// ensure never to have two negatives multiplied to make a positive 

currentBlocksize = (this.pageBlock < 0 ? 0 : this.pageBlock) * 

(retrievecount < 0 ? 0 : retrievecount); 

} 

// GET THE RESULTS 

// 

// Summary report result set 

// 

if (this.isSummaryReportO) { 
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while (result. nextQ) { 

rows = new HashMapO; 

/* Retrieve Data for each sort field 

*/ 

//Z. probe( M soFields.size — " + soFields.sizeO) ; 

//Z. probe("groupByAliases.size=" + groupByAliases.sizeQ) ; 

//Z. probe("soFields== " + soFields); 

//z. probe( M groupByAliases=" + groupByAliases) ; 

Iterator gbi = groupByAliases. keyset () .iterator () ; 
int k = 0; 


while (gbi . hasNextO) { 

alias = (String) gbi. next (); 


/* Deal with dates 


7 


if (ddeDisplayedDates. get (alias) != null) { 
//temp = result. getstring(alias) ; 

tempTimestamp = resul t .getTimestamp(alias) ; 
if (TextManager.isStringVisible(temp)) { 
temp = formatDateString(dbt, 
su, 

//Convert . getCal endarFromSt ri ng (sessi on p 

temp) , 

Conve rt . toCal endar (tempTi mes tamp) , 
emptystringspacer) ; 

} 

} else temp = 
this. get Pri ntableResul t( resul t.getst ring (alias)) ; 

rows. put (alias, 

TextManager . i sst ri nglnvi si bl e (temp) 

? "CALC" . equal s (g roupByAl i ases . get (al i as) ) 

? "0" : emptystringspacer 

: temp) ; 

/* Deal with values & dates 

*/ 

if ("D" . equal s(groupByAl i ases . get(al i as))) { 
tempTimestamp = result.getTimestamp(alias + 
valuesufx); // this was getstringO 
// Convert . toCalendar(tempTimestamp) ; 

if (TextManager. isstri ngvi si ble(temp)) { 
temp = formatDateString(dbt, 
su, 

Convert . toCal endar (tempTi mes tamp) , 
//Convert . getCal endarFromSt ri ng (sessi on , 

result. getstring(alias + valuesufx)), 

emptystri ngspacer) ; 
rows . put (a lias + valuesufx, temp); 

} 

else if ("Y".equals(grou|DByAliases.get(alias))) { 
temp = result .getstring (alias + valuesufx); 
rows. put (alias + valuesufx, temp); 

} } 

if (this.calculatedFields.size() == 0) 
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rows . put (i dcountAl i as , resul t - getst ri ng (i dCountAl i as) ) ; 

// the count 

resul ts. add (rows) ; 
} // end while 
}// end if summary report 

// NOT A SUMMARY REPORT RESULT SET 

else if (this.unlimitedResults) { 

// LIMIT_QUERY_R0WS is the maximum allowable returned results for an unlimited query 
if you are NOT IN the ADMIN_BYPASS_GROUP 

this.checkMaxRows = 

! sessi on . getUserRol e () . equal slgnoreCase(Z . appDef aul ts . getAtt ri bute("ADMIN_BYPASS_GRO 

up")); 

if (checkMaxRows) { 
if 

(TextManager . i sstri ngvi si bl e(z . appDef aul ts . getAtt ri bute("LlMlT_QUERY_ROWS"))) { 

if 

(Z. appDef aul ts. getAttri bute("LIMiT_QUERY_ROWS") .indexOf ("DEFAULT") == -1) 

this.maxRows = 

integer. parselnt(z. appDef aul ts. getAtt ribute("LIMlT_QUERY_ROWS")) ; 

Z.loq.writeToLog(Z.log.DEBUGl, "RPT: unlimi ted/checkmax = " + 
this.unlimitedResults + /" + checkMaxRows); 

while (resul t. next()) { 

// if the results are unlimited then limit to 5000 ids in memory at a time 

// 

rsRownum++; 

f lushToPersi st (persist , resul t. getst ring (1)) ; 
if (this.checkMaxRows) { 

if (this.maxRows <= rsRownum) break; 

} 

} // end while 
} // end if 

// The results are limited to one pageBlock 

// where pageBlock = max (2 5 , 100, 500) x 10 pgs = total ids in memory at a time 

else{ 

else { 

while (result . nextO) { 

if (++rsRownum > (lastBlockSize)) 

f 1 ushToPersi st (persi st , resul t . getst ri ng (1) ) ; 
else continue; 

if (rsRownum == (currentBlockSize)) break; 

} 

} 

boolean allFetched = result. isAfterLast() ; 

if Othis.isSummaryReportO) { 
if (doAttachAlert) { 

Resul tset sumAttachResul t = 
sumAttachStatement . executeQuery () ; 
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if (sumAttachResult.nextO) this, total Attachments! ze = 
sumAttachResult.getlnt(l) ; 

Z.loq.writeToLog(Log.DEBUG3, this, "rpt***** THE 
this . total^attatchment_size : + thi s . resul tcount) ; 

} // Only do the count if necesssary 

else if (! all Fetched && countstatement != null) { 

Resul tset countResult = countstatement .executeQueryO ; 

if (countResult. next()) this . resul tcount = 

countResult .getlnt(l) ; 

} else if (all Fetched) this. resul tcount = rsRownum; 
Z.loq.writeTol_og(Log.DEBUG3, this, "rpt***** THE 
THIS.RESULT_COUNT:" + thi s . resul tcount) ; 

} 

} // end if not a timeSeries 


} 

catch (Exception e) { 

Z.log.writeToLog (Log. ERROR, this, "Error in method getList:" + e) ; 
ErrorWri ter.write(e, ErrorWri ter . LOG) ; 
throw e; 

} 

finally { 
try { 

if (statement != null) statement. close() ; 

} 

catch (Exception el) { 

Z. log. writeToLog(Log. ERROR, this, "Error in method getList:" + el); 
ErrorWri ter .write (el, ErrorWri ter . LOG) ; 

} 

try { 

if (countstatement != null) countstatement .close() ; 

catch (Exception e2) { 

Z. log. writeToLog(Log. ERROR, this, "Error in method getList:" + e2) ; 
ErrorWriter.wri te(e2 , ErrorWri ter . LOG) ; 

statement = null ; 
countstatement = null; 

return results; // if not a summary report then this is 0 
} //end get masterlist 

* flushToPersist() 

* @param Persist persist 

* @param String results 

V 

private void flushToPersist(Persist persist, String result) throws Exception { 
if (isNewPersist) { 

persi st . wri teNew(resul t) ; 

isNewPersist = false; 
} else { 

persist .write (result) ; 


} 


private PreparedStatement bindParams(ArrayList params, 
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ArrayList types, 

Preparedstatement statement) throws Exception{ 

try{ 

String bindType = ""; 

for (int k = 0; k < params.sizeQ ; k++) { 
bindType = (string) types. get (k) ; 
if (bindType. equal slgnoreCase("STRING")) { 

statement. setstnng(k + 1, (String) params.get(k)) ; 

else if (bindType. equal slgnoreCase("DATE")) { 

statement. setTimestamp(k + 1, (Timestamp) params.get(k)) ; 

} 


catch(Exception e){ 
throw e; 

} 

fi nal ly{ 

return statement; 

} 


^/*********************************************************************************** 
********************** 

************************************************************************************ 
********************* 

* getSelectO 

* ©return select string 

* 

* Builds the select clause for an individual record — does this in blocks 

of 20 records at a time. 

* 

* This is done in three queries due to multiple repeating values associated 

* with problem modules and problem releases. The three queries are: 

* 

* 1) problem table as driver table 

* 2) problem release as driver table 

* 3) problem module as driver table 

* 

* Get the data for a block of 20 (this is the smallest page size) using an IN 
clause, 

* the concatenation hint and correlated sub-queries in the select clause 
(whenever possible) 

* to acheive the FASTEST performance. 

* (To use correlated sub-queries, you will need to make any field deep in the 

* table hierarchy a lookup in the data dictionary : 

* — ie. module name is a lookup of module. title done from the 
problem_module table 

* — ie. module type is a lookup of module_type. title done from the module 

table ) 

* 

* Then you must SORT the results. To do this you will parse the block of 20 
results 

* to match order the master list, sortedKeys (retrieved from the persist 
object) 

* that was used to generate the IN clause. Therefore you combine the problem 
results, 

* problem release results and problem module results, sequentially by 
sortedKey . 
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* So you have processed your block of 20 but the user wants 50 results per 
page. . . Fi rst, you 

* return the results as a ValidationList (a hashmap that keeps its order FI 
This list This means get 

* Select gets called again from getNextBlockResul ts() 

******************************************************* 
********************** 


******************************************************************************** 
*********************** j 

private ValidationList getSelect(Connection conn, ArrayList sortedKeys, 
SesameSession session) throws Exception { 


/* DDEntries 


// 


it ii 


7 


ii ti 


ii ii 


ii 1 1 


ii ti 


ii ii 


ii ii 


ii ii 


ll n 


string ddeType = 
String ddeTable = 
String driverKey = "ITEMED"; 

String problemKey = "ITEM_ID M ; 
string problemudf DriverKey = "ITEM_ID" ; 
String driverTableAlias = "p" ; 
String tmpDri verTabl e = 
string ddeField = 
String ddeName = 
String ddeLookupTable = 
String ddeLookupCol umnl = 
string ddeLookupCol umn2 = 
String ddeLookupCol umn3 = 
string ddeLookupKey = "" : 
String ddeParentTable = 
String ddeGrandParentTable = 
String ddeGrandParentKey = 
String ddeGrandChildKey = ""; 
String ddeParentKey = ; 
String ddeChildKey = ""; 
String ddeDisplayType = ""; 
string ddeMultipleValue = ""; 
String ddeltemTypeld = "" ; 
HashMap ddeDisplayedDates = new HashMapO; 
HashMap prDisplayedDates = new HashMapO; 
HashMap ddeTextFields = new HashMapO; 
HashMap ddeDisplayURLs = new HashMapO; 

/* Used to build query string 


ii 1 1 


n ii 


bool 
bool 
bool 
bool 
bool 
bool 
bool 
bool 
bool 
bool 
bool 
stri 
stri 
stri 
Stri 


*/ 


ean hasGrandParentTabl e = false; 
ean doPQuery = false; 
ean doPMQuery = false; 
ean doPRQuery = false; 
ean doPAQuery = false; 
ean doRGQuery = false; 
ean doUDFTextQuery = false; 
ean doReleaseUdfTextQuery = false; 
ean doUDFMul ti Query = false; 
ean doReleaseudfMul tiQuery = false; 
ean hasDri verTabl e = false; 
ng ORDER_BY = " order by 
ng temp = "" ; 
ng aliasedDri verTabl e = 
ng pKey = ""; // this is the problem Id as a 
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String lookupSql = ""; 

String key = " ; // this is a generic variable used as a key in HashMaps 

StringBuffer inCriteria = new stringBufferO ; 

JoinData p_jd = new DoinDataO; 

JoinData pr_jd = new 3oinData(); 

JoinData pm_jd = new DoinDataO; 

JoinData pa_jd = new JoinDataO; 

/* Problem Table Query 

*/ 

boolean pFromTables = false; // are there tables in the from clause? 
int pselectcnt = 0; 
string tempAlias = "" ; 
String pQuery = ""; 

StringBuffer pselect = new stri ngBuffer ("sel ect " + this.concatHint); 
StringBuffer pFrom = new Stri ngBuffer (" from "); 

StringBuffer pwhere = new Stri ngBuffer (" where p." + driverKey + " in "); 
ArrayList pParams = new ArrayListO; // Bind Parameters for SQL UDF 

fields 

ArrayList problemFieldList = new ArrayListO; // the list of ddnames that 
are in the problem query 

HasnMap pRows = null; 
HashMap pResults = null; 

../* Problem Release Table Query 

*/ 

boolean prFromTables = false; // are there tables in the from clause? 
int prselectcnt = 0; 
String prQuery = ""; 

StringBuffer prSelect = new Stri ngBuffer ("sel ect " + this.concatHint); 
StringBuffer prFrom = new Stri ngBuffer (" from "); 

StringBuffer prwhere = new stri ngBuffer (" where i r . problem_release_id in "); 
ArrayList prParams = new ArrayListO; // Bind Parameters for SQL UDF 

fields 

HashMap prResults = null; 

String rQuery = "select iteml_id from item_group where i tem_group_type_id =1 
and item2_id in"; 

StringBuffer rlnCriteria = new StringBufferO; 
. ArrayList releaseFieldList = new ArrayListO; // the list of ddnames that 
are in the release query 

/* Problem Module Table Query 

*/ 

boolean pmFromTables = false; // are there tables in the from clause? 
int pmSelectCnt = 0; 
String pmQuery = ""; 

StringBuffer pmselect = new stringBuffer("select " + this.concatHint); 
StringBuffer pmFrom = new Stri ngBuffer (" from "); 

// ******CHANGED THIS TO LOOKUP ON ITEM_ID 

StringBuffer pmwhere = new stri ngBuffer (" where im.item_module_id in "); 
HashMap pmResults = null; 

String mQuery = " select i tem_module_id " + 

" from item_module " + 

" where iterrumodule.i tem_id in "; 
StringBuffer mlncriteria = new StringBufferO; 

ArrayList moduleFieldList = new ArrayListO; // the list of ddnames that 
are in the module query 

/* Attachment Table Query 

*/ 

boolean paFromTables = false; // are there tables in the from clause? 
int paSelectcnt = 0; 
String paQuery = ""; 
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StringBuffer paselect = new stringBuffer("select " + 
stringBuffer paFrom = new StringBuffer ( M from "); 
StringBuffer pawhere = new stringBuffer(" where a. attachments" d in ") ; 
HashMap paResults = null; 
String aQuery = " select attachments" d " + 

" from attachment " + 

" where attachment. item_id in "; 
StringBuffer alnCriteria = new StringBuffer () ; 

ArrayList attachmentFieldList = new ArrayListO; // the list of ddnames 
that are in the attachment 

/* Relationship Group Table Query 

*/ 

boolean rgFromTables = false; // are there tables in the from clause? 
int rgselectcnt = 0; 
String rgQuery = ""; 

StringBuffer rgSelect = new Stri ngBuf f er ("sel ect " + this.concatHint); 
StringBuffer rgFrom = new Stri ngBuf fer(" from "); 

StringBuffer rgwhere = new stri ngBuf fer(" where rg. relationships roup_id in 


); 


HashMap rqResults = null; 
String re lationshi pQuery = 


it 


select relationship_group_id 5 + 
from relationship_group_view " + 
where relationship_group_view.item_id in "; 
StringBuffer rglncriteria = new Stri ngBuf fer() ; 

ArrayList rgFieldList = new ArrayListO; // the list of ddnames that are in 
the attachment 


/* UDF MultiRow Queries 


* 


H ii 


/ 


String udfQuery = 
ArrayList udfNameParams = new ArrayListO; 
ArrayList udfTextFields = new ArrayListO; 
ArrayList releaselidfTextFields = new ArrayListO; 
ArrayList udf FieldResul ts = new ArrayListO; 
HashMap udf Results = null; 

final string problemUdfTextKey = M PROBLEM_TEXT_ID" ; 

ArrayList udfMulti Fields = new ArrayListO; 
ArrayList releaseudfMulti Fields = new ArrayListO; 

/* Data Alias Names used for retrieving results from a result set 

HashMap pDataAlias = new HashMapO; 
HashMap pmDataAlias = new HashMapO 
HashMap prDataAlias = new HashMapO 
HashMap paDataAlias = new HashMapO 
HashMap rgDataAlias = new HashMapO 

/* For Transacting Queries 


/ 


ResultSet pRs = null 


V 


ResultSet prRs = null 
ResultSet pmRs = null 
ResultSet paRs = null 
ResultSet rgRs = null 
ResultSet udfRs = null; 
Preparedstatement pstmt = null; 
Preparedstatement prstmt = null; 
Preparedstatement pmstmt = null; 
Preparedstatement paStmt = null; 
Preparedstatement rgStmt = null; 
Preparedstatement udf Stmt = null; 
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/* Other 


V 

String listKey = ""; 

ArrayList leList = new ArrayList(); 

ArrayList dataList = null; 

ArrayList releaseKeys = null; 
ArrayList moduleKeys = null; 
ArrayList attachmentKeys = null; 
ArrayList rgKeys = null; 

HashMap distinctTables = new HashMapO; 
HashMap tempHash = null; 
LayoutElement le = null; 
DDEntry thisDDE = null; 

ValidationList final Results = new ValidationListO ; 
HashMap dictionaryFields = new HashMapO; 
HashMap multiText = new HashMapO; 
DbTime dbt = null ; 
Securityuser su = null; 

// Regex replaceConcat = new Regex(esc+"~|~| " ,z.dbms.cat()) ; 

//Z.probe("RPT: IN GET SELECT ") ; 

try { 

dbt = new DbTime(session, conn); 

su = (Securityuser) session. getAttributeC'USER") ; 

y****************** ****** *********************************** 

* Make sure the layouts & layout elements are populated 

*********************************************************** i 

if (this.l == null) { 

Z.log.writeToLog(Z.log.DEBUG3, "THE LAYOUT IS NULL!!!!!!!!!!!!") 

throw new Exception("The layout is null"); 

} 

leList = 1 ,getElements() ; 
if (leList == null) { 

Z.loq.writeToLog(Z.log.DEBUG3, "Layout has 0 layout elements and 
therefore lei is null"); 

throw new Exception("The layout has no elements!!"); 

multiLookups = new HashMapO; 
dictionaryFields = Z. dictionary. getHashMapO ; 

/* Build the IN clause for getting a blocks worth of data 

*/ 

incriteria = bui 1 dlncl ause(sortedKeys) ; 

/** * ******************************************************** 

* Scan the Layout Elements for ATTACHMENT 

********************************************************** j 

boolean hasAttachment = false; 
boolean hasRG = false; 
String leName = ,,M ; 

ArrayList leNameList = new ArrayList(); 

for (int i - 0; i < leList. size() ; i++) { 

leName = ((LayoutElement) leList .get(i)) .getDdName() ; 
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Z.log.writeToLog(Z.log.DEBUG3,"THE REPORT LAYOUT ELEMENTS ARE 


i f ("ATTACHMENT" . equal slgnoreCase(l eName)) 

hasAttachment = true; 
else if ( M RELATlONSHlP_GROUP".equalslgnoreCase(leName)) 
hasRG = true; 

else 

leNameLi st .add (leName) ; 

// // add the release one. 

// 1 eNameLi st . add(" PROBLEM_RELEASE__ID") ; 

if (hasAttachment) { 


leNameLi 
leNameLi 
1 eNameLi 
1 eNameLi 
1 eNameLi 
leNameLi 
leNameLi 


St . add("ATTACHMENT_ID") ; 
St . add("ATTACH__FILE_DESC") ; 
st.add("ATTACH_FILE_NAME") ; 
St. add("ATTACH_CONTENT_TYPE M ) ; 
st.add("ATTACH_FILE_SIZE") ; 
St . add("ATTACH_DATE_CREATED") J 
St . add("ATTACH_PATH") ; 


} 


1 eNameLi st . add("ATTACH_CREATED_BY_USER") ; 


if (hasRG) { 


leNameLi 
leNameLi 
leNameLi 
leNameLi 
leNameLi 


St .add("RELATIONSHIP_GROUP_ID") ; 
St . add("RELATIONSHIP_GROUP_TYPE") ; 
St . add("RELATIONSHIP_GROUP_TITLE") ; 
St.add("RELATIONSHIP_GROUP_OWNER") ; 
St.add("RELATIONSHIP_GROUP_ID") ; 
leNameLi St. add ("RELATIONSHIP_GRP_PARENT_ID") ; 

ReportElement re = new ReportElement(nul 1 , null , thi s . i sChart () , hr) ; 


probl emFi el dLi st . add (PR0BLEM_KEY_J\LIAS) ; 
rel easeFi el dLi st . add (PR0BLEM_KEY_J\LIAS) ; 
rel easeFi el dLi st . add (RELEASE_KEY_J\LIAS) ; 
modul eFi el dLi st . add (PROBLEM_KEY^ALlAS) ; 
attachmentFi el dLi st . add ( PROBL EM_KEY_JM_IAS) ; 

y'*********************************************************** 

* Process the Layout Elements 

********************* ************************************* ^ 

String baseName = ""; 

for (mt i = 0; i < leNameList.size() ; i++) { 

/* Get the Data Dictionary Entry 

*/ 

key = (string) 1 eNameLi st. get (i ) ; 

if ( key.indexof ("RANGE_START") > -1) 

baseName = key.substring(12) ; 
else if (key.indexof ("range_stop") > -1) 

baseName = key . substri ng(ll) ; 

else 

baseName = key; 
// Only process valid filter fields 

if ((thisDDE = (DDEntry) dictionaryFields.get(baseName)) == null 

continue; 

thi sDDE . set Name (baseName) ; 
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// f = this. fg.getFi Iter (key) ; 

/* Populate the string variables 

*/ 

ddeType = thisDDE.getTypeO ; 

ddeName = thisDDE.getName() ; 
ddeTable = thisDDE.getTableNameO == null ? 
thisDDE.getTableNameO ; 

if ( ! " PROBLEM_RELEASE" . equal slgnorecase (ddeTabl e) ) { 

if (thisDDE.getltemTypeldO != null) 

ddeitemTypeld = thisDDE.getltemTypeld() ; 
else ddeitemTypeld = 

// special case for release parents 

// 

else{ 

ddeitemTypeld = "1"; 

} 


it it 


/* If the Layout Element is not a database object we cannot use it in a query 

. */ 

if ( ! thi sDDE . i ssel ectForReports () 

&& ! "ATTACHMENT" . equal slgnorecase (ddeName) 

&& !"RELATlONSHlP_GROUP". equal slgnoreCase(ddeName)) { 

Z.log.writeToLog(Z.log.DEBUG5,"RPT: NOT Processing element: " 

+ ddeName + " NOT SELECTABLE FOR REPORTS"); 

conti nue; 

Z.log.writeToLog(Z.log.DEBUG5,"RPT:Processing report results layout 
element: " + ddeName + " is selectable FOR REPORTS ); 


Z.dbms.catO) ; 


if (thisDDE.getColumnNameO != null) 

ddeField = TextManager . replace(thisDDE.getColumnName() , "I I", 


else ddeField = 


ti it 


if (thi sDDE. getParentTabl e() !=null) 

ddeParentTable = thisDDE.getParentTable() ; 
else ddeParentTable = ""; 

ddeGrandParentTable = thisDDE.getGrandParentTable() ; 
if (! "" . equals(ddeGrandParentTable)) { 
hasGrandParentTable = true; 

ddeGrandParentKey = thi sDDE.getGrandParentKeyO ; 
ddeGrandchildKey = thisDDE.qetGrandChildKeyO ; 
} else hasGrandParentTable = false; 

//Z . probe ("AAAAAAAAAAAAAAhasGrandPar en tTabl eAAAAAAAAAA ; M +hasGrandParentTabl e) ; 

if (thi sDDE. get ParentKeyO != null) 

ddeParentKey = TextManager . replace(thisDDE.getParentKey() , "M", 


Z.dbms.catO) ; 


Z.dbms.catO) ; 


else ddeParentKey = ""; 

if (thi sDDE. getChildKeyO != null) 

ddeChildKey = TextManager. replace(thisDDE. getChildKeyO , "II", 

else ddeChildKey = ""; 
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thi sDDE . getLookupTabl e () ; 

ddeDi spl ayType 
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= thi sDDE. get LookupTable() == null ? 

= thi sDDE. getDi spl ayType () ; 


it ii 


if (thi sDDE. getLookupCol umnl( 
ddeLookupCol umnl = 
TextManager . repl ace(thi sDDE . getLookupCol umnl( 

else ddeLookupCol umnl = 


ii ii 


if (thi sDDE. getLookupCol umn2( 
ddeLookupCol umn2 = 
TextManager . repl ace (thi sDDE . getLookupCol umn2 ( 

else ddeLookupCol umn2 = 


ii n 


if (thisDDE.getLookupColumn3( 
ddeLookupCol umn3 = 
TextManager . repl ace (thi sDDE . getLookupCol umn3 ( 

else ddeLookupCol umn3 = "" ; 


!= null) 
, f, | I", Z.dbms.catO); 

!= null) 
, "||", Z.dbms.catO); 

!= null) 
, "| |", Z.dbms.catO); 


Z.dbms.catO) ; 


"N" 


if (thi sDDE. getLookupKeyO != null) 

ddeLookupKey = TextManager . repl ace(thisDDE. getLookupKeyO , 

else ddeLookupKey = ""; 

ddeMul tiplevalue = thisDDE.isMultipleValue() ? "Y" : 
if ("IMAGE". equal slgnoreCase(ddeDi spl ayType)) continue; // ski 

images 

if (thi sDDE. di spl ayAsURLO) ddeDisplayURLs.put(ddeName, 
thisDDE.getUrlO); 

//Z.probe("RPT:ddeDisplayURLs: " + ddeDisplayURLs) ; 

//z.probe("RPT: Processing layout element: " + ddeName + " IS IT MULTI: " + 
thi sdde . i sMul ti pi eval ue () ) ; 


J y'**** ****** * ******** ****************************************** 

// 

// SET THE DRIVER TABLES 

// 

J ^/*********** ********************** **************************** 

hasDriverTable = false; 

if (("ITEM". equal slqnoreCase(ddeTable) 

"ITEM* . equatslqnoreCase(ddeParentTabl e) 
"PROBLEM . equal slgnoreCase(ddeTable) 
" PROBLEM" . equal slgnorecase (ddeParentTabl e) 
"RELATIONSHIP_GROUP". equal slgnoreCase(ddeTable) 

"relationship_group_problem". equal signoreCase(ddeParentTable) 

|| ddeTable.startsWith("RELATlONSHlP_GROUP") 

&& ! ("PROBLEM^MODULE". equal slgnoreCase(ddeTable) 
"PROBLEM_RELEASE". equal slgnoreCase(ddeTable) 
"ATTACHMENT" . equal slgnorecase (ddeTabl e) 
(ddeTabl e) . startsWi th("ITEM_MODULE") 
(ddeTabl e) . startswi th("ITEM_RELEASE") 


{ 


) 
) 

tmpDriverTable = this.driverTable; 
driverKey = "ITEM^ID"; 
hasDriverTable = true; 
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if (! PROBLEM_KEY_J\LIAS. equal slgnoreCase(ddeName)) 
probl emFi el dLi st . add (ddeName) ; 

else if ("ITEM_M0DULE". equal slqnoreCase(ddeTable) 

"ITEMjviODULE. equal slqnoreCase(ddeParentTable) 
" PROBL EM_MODULE . equal slgnoreCase(ddeTabl e) 
,, PROBLEM_MODULE". equal slgnoreCase(ddeParentTable) 

(ddeTabl e) . startsWi th("lTEM_MODULE")) { 
tmpDriverTable = "ITEM_MODULE" ; 
driverKey = "ITEM_M0DULE_ID" ; 
hasDri verTable = true; 

if ( ! PROBLEM_KEY_JU_lAS . equal slgnoreCase (ddeName) ) 
moduleFieldList.add(ddeName) ; 

else if ("PROBLEM_RELEASE M . equal slgnoreCase (ddeTabl e) 

i "PROBLEM_RELEASE. equal slgnoreCase(ddeParentTable) 

I (ddeTabl e) .startsWi th("lTEM_RELEASE")) { 
tmpDriverTable = "problem_release" ; 
driverKey = M PROBLEM_RELEASE_ID" ; 
hasDri verTable = true; 

i f ( ! PROBL EM_KEY^ALIAS . equal slgnoreCase (ddeName) 

&& !RELEASE__KEY^ALIAS. equal slgnoreCase(ddeName)) 
rel easeFi el dLi st . add (ddeName) ; 

else if ("ATTACHMENT" .equal slgnoreCase(ddeTable)) { 
tmpDriverTable = "ATTACHMENT"; 
driverKey = "ATTACHMENT_ID" ; 
hasDriverTable = true; 

if (! PROBLEM_KEY_ALlAS. equal slgnoreCase (ddeName)) 
attachment Fi el dLi st . add(ddeName) ; 

} 

else { 

Z.log.writeToLog(this, Log . DEBUG4 , "Couldn't set driver table 
because we are too many levels out... DDETABLE =" + ddeTabl e); 

tmpDriverTable = ""; 
hasDriverTable = false; 

} 


y/^*********************************************************** 
//* Process the Query string - UDF Database Objects 

J ^****** ** * * * * ****** ******************************* 

if ("UDF" . equalslgnoreCase(ddeType)) { 

if ("1" . equalslgnoreCase(ddeltemTypeId)){ 
rel easeFi el dLi st.add(ddeName) ; 
tmpDriverTable = "PROBLEM_RELEASE" ; 
driverKey = "PROBLEM_RELEASE_lD" ; 

if (! prFromTables){ 
// Build the IN clause for getting a blocks worth of release stuff 


releaseKeys = buildReleaselnList( sortedKeys, rQuery + 
i ncri teri a. tost ri ng () , suppressedMul ti Rel easeFi 1 ters) ; 

rlnCriteria = bui 1 dmclause(releaseKeys) ; 

Z.probe(" > > > Processing Release Level UDF — 
rlnCriteria is " + rlnCriteria); 

z.probe( M > > > Processing Release Level UDF — 
releaseKeys is " + releaseKeys); 
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prwhere . append (rlnCri ten" a. toStri ng ()) ; 
//prFrom . append (al i asedDri verTabl e) ; 

pr_jd.addAll(tmpDriverTable,getAlias(tmpDriverTable)/ ,,, f 0); 

prFromTables = true; 

di sti nctTabl es . put (tmpDri verTabl e , thi sDDE) ; 

} 

} 

else{ 

probl emFi el dLi st . add (ddeName) ; 
tmpDri verTabl e = "ITEM"; 
driver Key = PROBLEM_KEY; 

if (! pFromTables) { 

pwhe re . append (i nCri te ri a . tost ri ng () ) ; 

p_id. addAl 1 (tmpDri verTabl e, 
getAliasCtmpDriverTable),""/","",""^); 

//pFrom.append(tmpDriverTable + " 11 + getAl i as (tmpDri verTabl e) ) ; 

pFromTables = true; 

di sti nctTabl es . put (tmpDri verTabl e , thi sDDE) ; 

} 


ddeName) ; 


Z. log. writeToLog (this, Log . DEBUG4 , " »> Processing UDF : 
tempAlias = ddeName; 

i f ("LIST" . equal slgnoreCase(ddeDi spl ayType) 

"POPUP" . equal slgnoreCase(ddeDi spl ayType) 
"TAB" . equal slgnoreCase(ddeDi spl ayType)) { 

if (thisDDE.isMultipleValueUdf ()) { 

if ("1" . equal slqnoreCase(ddeltemTypeld)){ 
tmpDri verTabl e = "item_udf" ; 
rel easelldf Mul ti Fi el ds . add (ddeName) ; 
doReleaseUdfMul tiQuery = true; 

el se{ 

tmpDri verTabl e = "ITEM_UDF"; 
udf Mul ti Fi el ds . add (ddeName) ; 
doUDFMul tiQuery = true; 

} 

} 

else { 

lookupsql = "( select distinct udf_list. title TITLE 

" from item_udf, udf_list, udf " + 
" where iterruudf." + PROBLEM_KEY + "= 
getAlias(tmpDriverTable)+ "." + driverKey + 

* and udf_list.udf_list_id = 


item_udf . udf_list_id "+ 


prParams . add(ddeName) ; 


" and udf.udf_id = i tem_udf . udf_id " + 
" and udf. name = ? ) " + q + tempAlias 4 

i f ("1" . equal slgnoreCase(ddeltemTypeld)) 

else pParams.add(ddeName) ; 
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} } 

else if ("DATE".equalslgnoreCase(ddeDisplayType)) { 

lookupsql = " (select distinct i tem_udf .value_date " + 

" from item_udf, udf " + 
" where item_udf." + PROBLEM_KEY + " = " + 
getAlias(tmpDri verTable)+ "." + driverKey + 

" and udf.udf_id = i tem_udf . udf_id "+ 

" and udf. name = ? ) " + q + tempAlias + q; 

i f ("1" . equal slgnoreCase(ddeltemTypeld)) { 
prParams.add(ddeName) ; 
prDi spl ayedDates . put (ddeName , " ") ; 

else{ 

pParams . add (ddeName) ; 

ddeDi spl ayedDates. put (ddeName, "") ; 

else if ("NUMBER" . equal slgnoreCase(ddeDi spl ayType)) { 

lookupsql = " (select distinct item_udf .value_number " + 

" from item_udf, udf " + 
" where item_udf." + PROBLEM_KEY + " = " + 
getAlias(tmpDriverTable)+ "." + driverKey + 

" and udf.udf_id = i tem_udf . udf_id " + 
" and udf. name = ? ) " + q + tempAlias + q; 
if ("1" . equal slgnoreCase(ddeltemTypeld)) 

prParams . add(ddeName) ; 

else pParams . add(ddeName) ; 

else if ("LOGAREA" . equal slgnoreCase(ddeDi spl ayType) 

"TEXTAREA" . equal slgnoreCase (ddeDi spl ayType) 
"PRINTTEXT" . equal slgnoreCase(ddeDi spl ayType)) { 

i f ("1" . equal slgnoreCase (ddeltemTypeld) ) { 
rel easeudf TextFi el ds . add (ddeName) ; 
doReleaseUdfTextQuery = true; 

} 

else{ 

udf Text Fi el ds . add (ddeName) ; 
doUDFTextQuery = true; 

tmpDriverTable = "ITENLTEXT" ; 

else if ( M USER".equalslgnoreCase(ddeDisplayType)){ 
lookupsql = 

" (select distinct security_user.fi rst_name " + 
" from item^udf, udf, securi ty^user " + 
" where item„udf .item_id = 11 
+getAlias(tmpDri verTable)+" . "+ driverKey + 

" and security_user . securi ty_user_id = 

item_udf .value" + 

" and udf.udf_id = i tem_udf . udf_id " + 
" and udf. name = ? ) " + q + tempAlias + q + 
", (select distinct securi ty_user . 1 ast^name " + 
" from item_udf, udf, securi ty_user " + 
where i tem_udf .item_id = 

+getAlias(tmpDriverTable)+"." + driverKey + 

" and securi ty^user. securi ty_user_id = 

i tem_udf . val ue" + 

" and udf.udf_id = i tem_udf . udf_id " + 

" and udf. name = ? ) " + q + tempAlias + this.sufxl 
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+ q + 


it 


+getAlias(tmpDriverTable)+ "." 


i temudf . val ue" + 


+ q + 


ti 


+getAl i as (tmpDri verTabl e) + " . 11 
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(select distinct security_user. email " + 
from item_udf, udf, securi ty__user " + 
where item_udf .item_id = 
driver Key + 

and security_user.security_user_id = 

and udf.udf_id = i terruudf . udf_i d " + 

and udf. name = ? ) " + q + tempAlias + this.sufx2 

(select distinct item_udf. value " + 
from item_udf, udf " + 
where item_udf .item_id = 
driverKey + 

and udf.udf_id = i tem_udf . udf_id " + 

and udf. name = ? ) " + q + tempAlias + this.sufx3+ 


q; 


if ("1" . equal slgnoreCase(ddeltemTypeId)){ 

for (int n = 0; n < 4; n++) prParams . add(ddeName) ; 

} 

else{ 

for (int n = 0; n < 4; n++) pParams . add(ddeName) ; 

} 

} 

else{ 

lookupsql = " (select distinct item_udf .value " + 

" from item_udf, udf " + 
" where item_udf." + PROBLEM_KEY + " = 
M +getAlias(tmpDriverTable)+" . " + driverKey + 

" and udf.udf_id = item^udf .udf^id " + 

" and udf. name = ? ) " + q + tempAlias + q; 


prParams . add(ddeName) ; 


} 


if ("1" .equal slgnoreCase(ddeltemTypeld)) 
else pParams . add(ddeName) ; 


} 


I* ************************************************* 

* Process the Query string - NON-UDF Database Fields 

************************************************************/ 

•4 

else { 


// Track the dates that will need formatting 

// 

i f ("date" . equal s (ddeDi spl ayType) ) 
ddeDi spl ayedDates . put (ddeName , " ) ; 

if ("TEXTFIELD". equals (ddeDi spl ayType)) 
ddeText Fi el ds . put (ddeName , " ") ; 


/** ***************************************************** ******** 
* Process the Query String - Build the from / where clause 


*************************************************************** j 


Page 94 


Report. java 
if (hasDri verTable) { 

if (distinctTables.get(ddeTable) == null) { // get distinct 

table 

ali asedDri verTable = tmpDri verTable + " " + 

getAli as (tmpDri verTable) ; 

if (IpFromTables && 
"ITEM" . equal slgnoreCase(tmpDri verTable)) { 

pwhere . append (i nCri teri a . toStri ng ()) ; 

pi d . addA 1 1 (tmpDri ve rTabl e , 
getAl i as (tmpDri ve rTabl e) ,"","", ,,K , , 0) ; 

pFromTables = true; 

} 

else if (! pmFromTables && 
"ITEM_M0DULE" .equal slgnorecase (tmpDri verTable)) { 

/* Build the IN clause for getting a blocks worth of module stuff 

*/ 

moduleKeys = bui ldlnl_ist(sortedKeys , mQuery + 

incriteria. toStringO /*+ 

ORDER_BY + " ITENLMODU L E_I D DESC"*/) ; 

mlncriteria = buildlnClause(moduleKeys) ; 
pmwhere . append (mlnCri teri a. tost ri ng () ) ; 
//pmFrom . append(al i asedDri verTab I e) ; 

pm_j d . addAl 1 (tmpDri ve rTabl e , getAl i as (tmpDri ve rTabl e) , " " , " " , " " , " " , 0) ; 

pmFromTables = true; 

else if (IprFromTables && 
"PROBLEM_RELEASE n .equal slgnorecase (tmpDri verTable)) { 

/* Build the IN clause for getting a blocks worth of release stuff 

*/ 

releaseKeys = bui ldReleaselnList( sortedKeys, rQuery 
+ incriteria. toStringO , suppressedMultiReleaseFilters) ; 

rlncriteria = bui IdlnClause(releaseKeys) ; 

prwhere . append (rlnCri teri a. tost ri ng()) ; 
//pr From . append (al i asedDri verTabl e) ; 

pr_j d . addAl 1 (tmpDri verTabl e , getAl i as (tmpDri ve rTabl e) , " " , " " , "", " " , 0) ; 

prFromTables = true; 

else if (! paFromTables && 
"ATTACHMENT". equal slgnoreCase(tmpDri verTable)) { 

/* Build the IN clause for getting a blocks worth of release stuff 

_ _ */ 

attachmentKeys = bui ldlnList (sortedKeys, aQuery + 

i nCri teri a. toStri ng() 

/* + ORDER_BY + "DATE_CREATED DESC"*/) ; 

if (attachmentKeys. si ze() == 0){ 
doPAQuery = false; 
continue; 

alnCntena = 

bui 1 dlncl ause(attachmentKeys) ; 

pawhere . append (alnCri teri a . toStri ng () ) ; 
pa_ j d . addAl 1 (tmpDri ve rTabl e , getAl i as (tmpDri ve rTabl e) , " " , " " , " " , " ", 0) ; 
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paFromTables = true; 


// If parent table is driver table - one table out 

// 


hasGrandParentTable) ; 
tmpDriverTable) ; 
ddeParentTable) ; 
hasGrandParentTabl e) { 


Z. probe ("~:o)->-< 
z. probe ("~:o)->-< 


ddeName = " + ddeName ) ; 
hasGrandParentTable = " + 


getAl i as (ddeParentTabl e) , 


Z.probe( M ~:o)->-< @@@@ tmpDriverTable = " + 
Z.probe("~:o)->-< @@@@ ddeParentTable = " + 
if (ddeParentTable. equalslgnoreCase(tmpDriverTable) | | 

i f ("ITEM" . equal slgnoreCase(tmpDri verTabl e) ) { 

p_j d . addAl 1 (ddeTabl e , 

getAl i as (ddeTabl e) , 

p_jd.LEFT_JOIN, 

ddeChildKey, 

hasGrandParentTable ? ddeParentTable : 
ddeParentKey , 

i); 


if (hasGrandParentTable && 
distinctTables. get (ddeParentTable) == null){ 

pr_j d . addAl 1 (ddeParentTabl e , 
ddeParentTable, 

p_jd.LEFT_JOIN, 

ddeGrandchi 1 dKey , 
ddeGrandParentTabl e , 
ddeGrandParentKey , 
2); 

} 

} 

else if 

(tmpDriverTable. startsWi th("PROBLEM_RELEASE ,, )){ 

if 

(ddeTabl e . equal slgnoreCase (" PRODUCT_RELEASE") ) { 

temp = "PRODUCT_RELEASE.PRODUCT_NAME " + 

Z.dbms.ojequals() + getAl i as (tmpDriverTable; + " . PRODUCT_NAME " + 

" and PRODUCT^RELEASE. RELEASE " + 

Z.dbms.oj equal s() + getAl i as (tmpDriverTable) + " . RELEASE_FOUND "; 

prwhere . append(temp) ; 
pr From. append (ddeTabl e) ; 

else{ 

pr_jd.addAll (ddeTabl e, 

getAl i as (ddeTabl e) , 

p_jd.LEFT_DOIN, 

ddechi IdKey , 

hasGrandParentTable ? ddeParentTable 


: getAl i as (ddeParentTabl e) , 


} 


ddeParentKey, 
1); 


if (hasGrandParentTable && 
distinctTables. get (ddeParentTable) == null){ 

pr_j d . addAl 1 (ddeParentTabl e , 
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ddeParentTable, 
p_jd.LEFT_.JOIN, 
ddeGrandchi 1 dKey , 
ddeGrandParentTabl e , 
ddeGrandParentKey, 
2); 

} 


else if (tmpDriverTable.startsWith( M ITEM_MODULE")){ 

pm_j d . addAl 1 (ddeTabl e , 

getAl i as (ddeTabl e) , 

p_jd.LEFT_JOIN, 

ddeChildKey, 

hasGrandParentTable ? ddeParentTable : 

getAl i as (ddeParentTabl e) , 

ddeParentKey, 
1); 

if (hasGrandParentTable && 
distinctTables.get(ddeParentTable) == null){ 

pm_jd. addAl 1 (ddeParentTable, 
ddeParentTable, 

p_jd.LEFT_JOIN, 

ddeGrandchi 1 dKey , 
ddeGrandParentTabl e , 
ddeGrandParentKey, 
2); 

} 

} 

} 

di s ti nctTabl es . put (ddeTabl e , thi sDDE) ; 
} // end build from/ where 

^************************************************************* 

* BUID THE SELECT CLAUSE 

**************************** 

lookupsql = buildLookupSql (ddeName, 

ddeTabl e, 

ddeField, 

dri verKey , 

ddeChildKey, 

ddeParentTable, 

ddeParentKey, 

ddeGrandParentTabl e , 

ddeGrandParentKey, 

ddeGrandchi 1 dKey , 

ddeLookupTable, 

ddeLookupCol umnl, 

ddeLookupCol umn2 , 

ddeLookupCol umn3 , 

ddeLookupKey , 

ddeDi splay Type, 

ddeMul ti pi eVal ue) ; 

Z.probe(" ddeName, = "+ ddeName); 
Z. probe(" ddeTable,= "+ ddeTable ); 
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Z. probe 
Z. probe 


ii 
1? 
ii 
n 
ii 
f i 
1 1 
t f 
it 
ii 
ii 

ii 
ii 
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ddeField,= "+ ddeField); 
driverKey,= "+ driverKey); 
ddeChildKey,= M + ddeChildKey ); 
ddeParentTable,= "+ ddeParentTable ); 
ddeParentKey ,= "+ ddeParentKey ); 
ddeGrandParentTable,= "+ ddeGrandParentTable ); 
ddeGrandParentKey,= "+ ddeGrandParentKey ); 
ddeGrandchildKey,= "+ ddeGrandChildKey) ; 
ddeLookupTable,= "+ ddeLookupTable) ; 
ddeLookupColumnl,= "+ ddeLookupColumnl ) 
ddeLookupColumn2,= "+ ddeLookupColumn2) 
ddel_ookupColumn3,= M + ddeLookupCol umn3 ) 
ddeLookupKey,= "+ ddeLookupKey ); 
ddeDisplayType,= "+ddeDisp layType ); 
ddeMul ti pi eValue= "+ ddeMul tip I eValue ); 


Z.probe("@; a)->-< loookupsql is : " + lookupSql); 

}// end if has driver table 
} // end if /else UDF 

/****************** X****************************************** 

* BUID THE SELECT CLAUSE - PROBLEM TABLE 

********************************** 

i f ("item" . equal slgnoreCase(tmpDri verTable)) { 

//Z.probe("RPT: DOING ITEM TABLE QUERY STRING STUFF"); 

// Always include the driver table primary key — ALWAYS 

if (IdoPQuery) { 

temp = getAli as (tmpDri verTable) + "." + PROBLEM_KEY + " " + 

q + PROBLEM_KEY_ALIAS + q + ", * ; 

pDataAl i as . put (PROBLEM_key_alias , ddeMul ti pi eval ue) ; 

//Z.probe("RPT: DOING ITEM TABLE QUERY STRING STUFF just set 


temp :" +temp) ; 


doPQuery = true; 

// Build the select clause 

// 

if (pselectcnt++ > 0) pSelect.append(" , "); 

else pselect.append(temp) ; // must always have this 

pSelect.append(lookupSql) ; 

// Save the data aliases - parameters are from lookupSql 

// 

if ("UDF" . equal slgnoreCase(ddeType)){ 

if ("USER" . equal slgnoreCase(ddeType)) { 

pDataAl i as . put (tempAl i as , ddeMul ti pi eval ue) ; 
pDataAl i as . put (tempAl i as+thi s . suf xl , ddeMul ti pi eval ue) ; 
pDataAl i as . put (tempAl i as+thi s . suf x2 , ddeMul ti pi eval ue) ; 
pDataAl i as . put (tempAl i as+thi s . suf x3 , ddeMul ti pi eval ue) ; 

} 

else 

pDat aAl i as . put (tempAl i as , ddeMul ti pi eval ue) ; 

} 

else { 

Iterator dai = dataAl i as. keyset () .iterator () ; 

while (dai . hasNextO) { 
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temp = (String) dai.next(); 

pDataA"lias.put(temp, (string) dataAlias.get(temp)) ; 

} 

} 

} 

/**************** *********************** ********************** 

* BUID THE SELECT CLAUSE - PROBLEM_MODULE TABLE 

**************************************************************/ 

else if (tmpDriverTable.startsWith( ,, ITEM_MODULE")) { 

/* Always include the driver table primary key — ALWAYS 

*/ 

if (IdoPMQuery) { 

temp = getAli as (tmpDri verTabl e) + "." + PROBLEM_KEY + " " + 

q + PROBLEM_KEY_ALIAS + q + " , ; 

pmDataAl i as . put (PR0BLEM_KEY_JVLIAS , ddeMul ti pi eVal ue) ; 
doPMQuery = true; 

/* Build the select clause 

*/ 

if (pmselectcnt++ > 0) pmSelect.append(" , ") ; 

else pmselect.append(temp) ; // must always have this 

pmsel ect . append (1 ookupSql ) ; 

/* save the data aliases - parameters are from lookupSql 

*/ 

Iterator dai = dataAl i as. keyset () .iteratorO ; 

while (dai . hasNext()) { 

temp = (String) dai. next (); 

pmDataAl i as . put (temp , (St ri ng) dataAl i as . ge t ( t emp) ) ; 

} } 

y**************** ******************************* ************** 

// BUID THE SELECT CLAUSE - PROBLEM_RELEASE TABLE 

^^************************************************************^ 

else if (tmpDriverTable.startswith("PROBLEM_RELEASE M ) ) { 


Z. probe (" THE TEMP DRIVER TABLE IS : " + tmpDri verTabl e + " and 
the lookupSql is : " + lookupSql); 

// Always include the driver table primary key — ALWAYS 

// 

if (IdoPRQuery) { 

temp = getAli as (tmpDri verTabl e) + ".problem_id " + q + 

PROBLEM_KEY^ALIAS + q + " , U + 

getAli as (tmpDri verTabl e) + " . problem_release_id " + q 

+ RELEASE KEY_ALIAS + q + " , " ; 

//prDataAl i as . put (PROBLEM_KEY_ALlAS , ddeMul ti pi eval ue) ; 
prDataAl i as . put (RELEASE_KEY_ALIAS , "Y") ; 
doPRQuery = true; 

} 

// if (doReleaseudfMultiQuery){ 

// prDataAl i as . put (tempAl i as , " Y") ; 

// } 
// else{ 

// Build the select clause 

//.„. 
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if (prse1ectcnt++ > 0) prselect.append(", "); 

else prSelect.append(temp) ; // must always have this 

prSel ect . append (1 ookupSql ) ; 

// Save the data aliases - parameters are from lookupsql 

if ("UDF" . equal slgnoreCase(ddeType)) { 

i f ("USER" . equal slgnoreCase (ddeType) ) { 

prDataAl i as . put (tempAl i as , thi sDDE . i sMul ti pi eval ueUdf () 

? "y" : "n") ; 

prDataAl i as . put (tempAl i as+thi s . suf xl , 
thisDDE.isMultipleValueUdfO ? "Y" : "N"); 

prDataAl i as . put (tempAl i as+thi s . suf x2 , 
thi sDDE. isMulti pi eval ueudf() ? "Y" : "N"); 

prDataAl i as . put (tempAl i as+thi s . suf x3 , 
thi sDDE. isMulti pi eval ueudf() ? "Y" : "N"); 

} 

el se 

prDataAl i as . put (tempAl i as , thi sDDE . i sMul ti pi eval ueUdf () 


? "Y" : "N" ); 


// } 


} 

else{ 

Iterator dai = dataAlias. keyset () .iterator () ; 

while (dai . hasNext()) { 

temp = (String) dai.nextO; 

prDataAl i as . put (temp , (Stri ng) dataAl i as . get (temp)) ; 

} } 


} // end building the select clauseses 

/************************************************************* 

* BUID THE SELECT CLAUSE - ATTACHMENT TABLE 

************************************************ 

else if ("ATTACHMENT". equal slgnoreCase(tmpDriverTable)) { 

/* Always include the driver table primary key — ALWAYS 

*/ 

if (IdoPAQuery) { 

temp = qetAlias(tmpDriverTable) + "." + PROBLEM_KEY + " 

q + PROBLEM_KEY_JVLIAS + q + ", " ; 

paDataAl i as . put (PROBLEM_KEY_ALlAS , ddeMul ti pi eval ue) ; 
doPAQuery = true; 

} 

/* Build the select clause 

*/ 

if (paselectcnt++ > 0) paSelect . append(" , "); 

else paSelect. append(temp) ; // must always have this 

paSel ect . append (1 ookupSql ) ; 

/* Save the data aliases - parameters are from lookupsql 

*/ 

Iterator dai = dataAlias. keyset () .iteratorO ; 

while (dai .hasNextO) { 

temp = (string) dai.nextO; 

paDat aAl i as . put (temp , (St ri ng) dataAl i as . get (temp) ) ; 
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}// end if ATTACH EMNT = tmpDri verTable 
} //end for loop of layout elements 


String [] p_s = Z.dbms. bui 1 dFromCl auseCp_jd) ; 
pFrom. append (p_s[0]) ; 
pwhe re. append Cp_s[l]) ; 


Z. probe(" 


CLAUSE 
CLAUSE 


CLAUSE 
CLAUSE 


"); 


z . p r obe ( " mmmmmmmm 

"+ P_s[0]); 

Z.probeC"' 
"+ P-s[l]); 

Z.probeC"-"); 


QueryBui 1 der . bui 1 dFromCl ause ( j d) [0] P_FROM 
QueryBuilder.buildFromClause(jd) [1] p_where 


String[] pr_s = z.dbms.buildFromClause(pr_jd) ; 
prFrom.append(pr_s[0]) ; 
prwhere.append(pr_s[l]) ; 


Z.probeC" 
pr_s[0]); 

Z.probeC" 
pr_s[l]); 

Z.probeC"-"); 


QueryBui 1 der . bui 1 dFromCl ause ( j d) [0] PR_FR0M 
QueryBui 1 der . bui 1 dFromCl ause(j d) [1] PR_WHERE 


String[] pm_s = Z.dbms. bui 1 dFromCl ause (pm_jd) ; 
pmFrom . append (pm_s [0] ) ; 
pmwhe re. append Cpm_s[l]) ; 


CLAUSE : 
CLAUSE : 


It 


II 


z . probe ("@(a(a(a(a@(a@(a@@@@@(a(a 
+ pm_s[0]); 

Z. probe("< 
+ pm_s[l]); 

Z.probeC"-"); 


Que ryBui 1 der . bui 1 dFromCl ause Cj d) [0] PM_FROM 
QueryBui 1 der . bui 1 dFromCl ause C jd) [1] PM_WHERE 


String[] pa_s = z.dbms. buildFromClauseCpa_jd) ; 
paFrom.appendCpa_s[0]) ; 
pawhe re. append Cpa_s[l]) ; 


CLAUSE : 
CLAUSE : 

Z.probeC" 


Z.probeC"-"); 
Z.probeC" 
pa_s[0]); 

Z.probeC" 
pa_s[l]); 


Que ryBui 1 der . bui 1 dFromCl ause C j d) [0] PA_FROM 
QueryBui 1 der . bui 1 dFromCl auseC jd) [1] PA^WHERE 


ii 


); 


/* Build query string from its constituent parts 


7 


if CdoPQuery) pQuery = pSelect. toStringC) + pFrom. toStri ngC) + 
pwhere. tostringO ; 

if CdoPMQuery) pmQuery = pmSelect. toStringC) + pmFrom. toStri ngC) + 
pmwhere. tostringO + " order BY im.MODULE_lD DESC"; 

if CdoPRQuery) prQuery = prselect. toStringC) + prFrom. tostringO + 

prWhere. toStringC) + " ORDER BY i r . DATE_CREATED DESC"; 

if CdoPAQuery) paQuery = paSelect. tostringO + paFrom. toStri ngC) + 
pawhe re. tostringO + " ORDER BY a . DATE_CREATED ASC"; 

Z.log.wri teToLogCz.log. DEBUG, "RPT: pQuery : " + pQuery); 
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Z.l og.writeToLogCz.log. DEBUG, m rpt: pmQuery : " + pmQuery); 

2. log.writeToLogCz.log. DEBUG, 'rpt: prQuery : 15 + prQuery); 

Z.l og.writeToLogCz.log. DEBUG, "RPT: paQuery : " + paQuery); 

J* ************************************************* 

* Execute the query -- PROBLEM Driver Table 

***********************************************************/ 


String baseKey = 
String multi = ""; 
String multil = "" 
String multi 2 = "" 
String multi 3 = "" 
ArrayList lMulti = null; 
ArrayList lMultil = null; 
ArrayList lMulti2 = null; 
ArrayList lMulti3 = null; 
DDEntry ddeTemp = null; 
int udfcnt = 0; 


if (doPQuery) { 
try { 

HashMap pMulti Lookups = null; 

pResults = new HashMapO; 

pstmt = conn. prepareStatement(pQuery) ; 

pKey = ""; 

udfcnt = pParams.size() ; 


// Bind the UDF Parameters 

// 

for (int k = 0; k < udfcnt; k++) 

pstmt. setstring(k + 1, (String) pParams.get(k)) ; 

// Bind the block of problem IDs 

// 

for (int k = 0; k < sortedKeys.size() ; k++) 

pstmt. setstring(k + 1 + udfcnt, (String) sortedKeys.get(k)) ; 

// Execute the query 

// 

try { 

pRs = pstmt .executeQueryO ; 

catch (SQLException se) { 

Z. log. writeToLog(Log. ERROR, this, "Error in method 

getselect : " + se) ; 

if (pstmt != null) pStmt.close() ; 
return new ValidationList() ; 

} 

Set pdaSet = pDataAlias. keyset () ; 

// Process the result rest 

// 

while (pRs.nextO) { 

pRows = new HashMapO; 

pMulti Lookups = new HashMapO; 

Iterator pdalterator = pdaSet. iterator () ; 
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// Get the data comprising a record 

while (pdalterator.hasNextO) { 

key = (string) (pdalterator . next()) ; 

i f (PROBLEM_KEY_JM_IAS . equal slgnorecase (key) ) 
pKey = pRs. getst ring (key) ; 

// Get the base key (ddName) from the alias 

if (key.endswith(sufxl) || key.endsWith(sufx2) || 
key.endswith(sufx3)) //use sufxl-2~3 for internal processing 

baseKey = key . substri ng(0, key.length() - 

sufxl. lengthO) ; 

else 

baseKey = key; 
ddeTemp = (DDEntry) dictionaryFields.get(baseKey) ; 
if ("USER". equal slgnoreCase(ddeTemp == null ? "" : 

ddeTemp . getDi spl ayType () ) ) { 


// Check for a multi lookup --> currenly ONLY when display_type = user 
// — > TODO: display_as_ur 1 = y 


// 

//z . probe (" RPT : BASEKEY 


: " + baseKey) ; 


//z.probe("RPT: ddeTemp »>" +baseKey) ; 


process unprocessed fields 


if (pMulti Lookups. get (baseKey) == null) { // only 


multi 1 
multi2 
multi 3 


it n 

M II 
II II 


// LOOKUPl 


// LOOKUP2 


// LOOKUP 3 


// LOOKUP4 


// get the result 

// 


} 


multi = pRs.getString(baseKey) ; 
pMul ti Lookups . put (baseKey , baseKey) ; 


multil = pRs.getString(baseKey+sufxl) ; 
pMul ti Lookups . put (baseKey+sufxl, baseKey) ; 

multi 2 = pRs. getst ring (baseKey+suf x2) ; 
pMul ti Lookups . put (baseKey+suf x2 , baseKey) ; 


multi 3 = pRs. getst ring (baseKey+suf x3) ; 
pMul ti Lookups . put (baseKey+suf x3 , baseKey) ; 

pRows . put (baseKey , thi s . getEmai 1 Li nk (mul ti 3 , 
multi , 
multil, 
mul ti2)) ; 


} 

else { 

format based on diplay type 
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if (ddeDisplayedDates.get(key) != null) { 
temp = formatDateString(dbt, 
su, 

Convert . toCalendar(pRs.getTimestamp(key)) , 

emptyStri ngspacer) ; 


ddeDi splayURLs .get (key) . 


else if (ddeDi splayURLs. get (key) != null) { 
temp = getURLLink((String) 

pRs.getSt ring (key)) ; 

else if (ddeTextFi elds. get (key) != null) { 
temp = this.isTextOutputTypeQ ? 


pRs . getst ri ng (key) 

a 

TextManager . converturl (getPri ntabl eResul t (pRs . getstri ng(key))) ; 

} 

else 

temp = getPrintableResult(pRs.getString(key)) ; 

pRows . put (key , temp) ; 
} // end if processed user type 

} 

pResults.put(pKey, pRows) ; 

} catch (Exception e) { 

z.log.writeToLog (Log. ERROR, "Error in method getselect:" + e) ; 
//ErrorWri ter . write (e, ErrorWri ter . LOG) ; 

throw e; 
} finally { 

if (pStmt != null) pStmt.closeQ ; 

} 

} 

//z . probe( M RPT: HAshMAp PROBLEM RESULTS"+pResults) ; 

y****** ******************** ********************************* 

* Execute the query — PROBLEM_MODULE Driver Table 

*********************************************************** j 

if (doPMQuery) { 
//Z.probe( M RPT:<><><>moduleKeys = " + moduleKeys); 

try { 

if (moduleKeys == null) moduleKeys = new ArrayListO; 
if (moduleKeys. si ze() == 0) 

pmResults = new HashMapO; 
else { 

pmstmt = conn. prepareStatement(pmQuery) ; 

/* Bind the block of problem IDs 

*/ 

for (int k = 0; k < moduleKeys. si ze() ; k++) 

pmstmt. setstring(k + 1, (String) moduleKeys. get(k)) ; 

/* Execute the query and process the result set 

*/ 

pmRs = pmstmt. executeQueryO ; 

pmResults = processResults(pmRs, 
pmDataAl i as , 
ddeDi spl ayedDates , 
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ddeTextFields, 
ddeDisplayURLs, 
di cti onary Fi el ds , 
session) ; 

// z.probe("RPT:HAshMAp problem module RESULTS ="+pmResul ts) ; 

} catch (Exception e) { 

Z.log.writeToLog (Log. ERROR, "Error in method getselect : " + 
//ErrorWri ter. write (e, ErrorWri ter . LOG) ; 

throw e; 
} finally { 

if (pmstmt != null) pmstmt.closeO ; 

} 

} 

/*********************************************************** 

* Execute the query PROBLEM_RE LEASE Driver Table 

*************************************** 

if (doPRQuery) { 

Z.log.writeToLog(Z.log.DEBUG5,"RPT:<><>oprQuery = " + prQuery) 
Z. log. writeToLog(Z. log. DEBUGS , "RPT: ooorel easeKeys = ' + 

releaseKeys) ; 

try { 

if (releaseKeys == null){ 

releaseKeys = new ArrayListO; 
prResults = new HashMapO; 
doPRQuery = false; 

} 

else if (releaseKeys. si ze() == 0){ 
prResults = new HashMapO; 
doPRQuery = false; 

else { 

prStmt = conn. preparestatement (prQuery) ; 
udfcnt = prParams.size() ; 

// Bind the UDF Parameters 

// 

for (int k = 0; k < udfcnt; k++) 

prstmt.setstring(k + 1, (String) prParams.get(k)) ; 


/* Bind the block of problem IDs 

*/ 

for (int k = 0; k < rel easeKeys. si ze() ; k++) { 
//z. probe ((St ri ng) rel easeKeys . get (k)+" , ") ; 

prstmt.setstring(k + 1 + udfcnt, (string) 

rel easeKeys. get (k)) ; 


/* Execute the query and process the result set 

*/ 

prRs = prstmt.executeQueryO ; 

prResults = processResul ts(prRs , 
prDataAlias, 
prDi spl ayedDates , 
ddeTextFields, 
ddeDisplayURLs, 
di cti onary Fi el ds , 
session) ; 
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Z.probe("RPT:HAshMAp PROBLEM RELEASE RESULTS ="+prResul ts) ; 

} } 

catch (Exception e) { 

Z. log .wri teToLog (Log . ERROR, "Error in method getselect:" + e) ; 
//ErrorWri ter .wri te(e, ErrorWri ter . LOG) ; 

throw e; 

} 

finally { 

if (prStmt != null) prStmt.close() ; 

} } 

y* *************************************** ******************* 

* Execute the query ATTACHEMENT Driver Table 

***********************************************************/ 

if (doPAQuery) { 
try { 

if (attachmentKeys == null) attachmentKeys = new ArrayListQ; 
if (attachmentKeys, si ze() == 0) paResults = new HashMapO ; 
else { 

paStmt = conn. prepareStatement(paQuery) ; 

/* Bind the block of problem IDs 

*/ 

for (int k = 0; k < attachmentKeys. si ze() ; k++) 

paStmt. setstring(k + 1, (String) attachmentKeys .get (k)) ; 

/* Execute the query and process the result set 

*/ 

paRs = paStmt . executeQueryO ; 
paResults = processResults(paRs, 

paDataAl i as , 

ddeDi spl ayedDates , 

ddeTextFields , 

ddeDi spl ayURLs , 

di cti onary Fi elds, 

session) ; 

Z . probe ( M RPT: HAshMAp PROBLEM ATTACHMENT RESULTS 

="+paResul ts) ; 

} 

} catch (Exception e) { 

Z. log. wri teToLog (Log. ERROR, "Error in method getselect:" + e) ; 
//ErrorWri ter .write(e, ErrorWri ter . LOG) ; 

throw e; 
} finally { 

if (paStmt != null) paStmt. close() ; 

} } 

^************* ********** ************************************ 

* Execute the query — RELATIONSHIP_GROUP_PROBLEM = Driver Table 

*********************************************************** J 

if (doRGQuery) { 
try { 

if (rgKeys == null) rgKeys = new ArrayList(); 

if (rgKeys. si ze() == 0) rgResults = new HashMapO; 

else { 

rgstmt = conn. prepareStatement(rgQuery) ; 
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/* Bind the block of problem IDs 

_ */ 

for (int k = 0; k < rgKeys.sizeQ ; k++) 

rgStmt.setString(k + 1, (String) rgKeys.get(k)) ; 

/* Execute the query and process the result set 

. */ 

rgRs = rgstmt. executeQueryO ; 
rgResults = processResults(rgRs, 

rgDataAlias, 

ddeDi spl ayedDates , 

ddeTextFields, 

ddeDi spl ayURLs, 

di cti onaryFi el ds , 

session) ; 

//2.probe("RPT:HAshMAp RELATIONSHIP_GROUP_PROBLEM RESULTS = M +rgResul ts) ; 

} 

} catch (Exception e) { 

z. log. writeToLog(Log. ERROR, "Error in method getselect:" + e) ; 
//ErrorWri ter . wri te(e , ErrorWri ter . LOG) ; 

throw e; 
} finally { 

if (rgstmt != null) rgstmt .close() ; 

} 

} 


y****************************************** 

* Execute the query — TEXT AREA, LOG AREA UDFs 

************************************************ 

String multiudf Separator = 
z . appDef aul ts . getAtt ri bute("MULTlPLE_FlELD_SEPARATOR M ) ; 

if (doUDFTextQuery | | (doReleaseUdfTextQuery && doPRQuery)) { 

try { 

//Z.probe("RPT:In Report .GetSelect - if doUDFTextQuery = true"); 

boolean gotHash = false; 
boolean getNewList = false; 

int loopcnt = 0; 
Object tempobj = null; 


pKey = 


it it 


it ii 


M ii 


ii ii 


ng ptKey = 

ng pKeyPrev = 

ng ptKeyPrev = 

ng udfTextSql String 

ng tempResult = 


ti ii 


stn 
stri 
stri 
stri 
Stri 

Stri 
stri 
Stri 
Stri 
Stri 
Stri 
Stri 
Stri 

String inudfcriteria = "" 
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ngBuffer udfText = new Stri ngBufferQ ; 

ng udfTimestamp = ""; 

ng udfuser = 

ng udfName = ""; 

ng udfTextPrev = 

ng udfTimestampPrev = 

ng udfUserPrev = ""; 

ng udfNamePrev = "" ; 


it it 


it tt 
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Iterator udfRowlt = null; 

HashMap tempUdfHash = null; 
ArrayList tempTextList = new ArrayList(); 
ArrayList tempTimestampList = new ArrayList(); 
ArrayList tempUserList = new ArrayList(); 
ArrayList distinctUdfNameList = new ArrayList(); 
HashMap disti nctudf Names = new HashMapO; 

HashMap udfltem = new HashMapO; 


boolean multiudf Parents [] = 
{doUDFTextQuery , doReleaseUdfTextQuery} ; 


Z. probe("RPT:ln Report .GetSelect - doUDFMul tiQuery") ; 

// Process UDFS for each of the different Parent Tables (currently Items & 
Releases) 

// 


for (int x = 0; x < multiudf Parents . length; x++){ 

if (! multiudf Parents [x]) continue; 

if ( X == 0){ 

doUDFMul tiQuery = true; 
doReleaseUdfTextQuery = false; 

if (x == 1){ 

doUDFMul tiQuery = false; 
doReleaseUdfTextQuery = true; 

} 

// Loop through each of the UDF's individually. Append each one to 
// pRows in pResults given a problem id 

if (doReleaseUdfTextQuery) { 
doUDFTextQuery = false; 


new HashMapO ; 


PROBLEM_KEY + 


M it 


if (IdoPRQuery && ! doReleaseUdfTextQuery) prResults = 
inudfcriteria = rlnCriteria. toStringO ; 
udfTextsqlStri ng = " select i tem_group. i tem2_i d " + 


ii 


i nudf Cri te ri a . tost ri ng () + 


• i 
ii 
ii 
ii 

ii 
ii 
ii 
n 

ii 


i tem_text . i tem_i d PROBLEM_RELEASE_ID + 
udf.name UDF_NAME " + 
i tem_text. text TEXT " + 
item_text. text_seq TEXT_SEQ " + 
i tem_text.id_seq + problemUdfTextKey + 
i tem_text. timestamp TIMESTAMP " + 
i tem_text. user_id USER_ID " + 
securi ty_user.fi rst_name FIRST_NAME " + 
security_user.last_name LAST_NAME " + 
securi ty_user. email EMAIL " + 
from securi ty_user, udf, item_text, item^group 


where item_text.item_id in 


and udf.name = ? 


it 
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" and item_group.iteml_id = item_text.item_id " 

+ 

" and i tem_text . user_id = 

security_user. securi ty_user_id " + 

" and udf.udf_id = item_text.udf_id " + 
" order by item_group.item2_id, 
i tem_text.item_id, item_text.id_seq asc, i tem_text. text_seq asc " ; 

} 


HashMapO ; 


PROBLEM_KEY+ 


inudfcriteri a. toStringO + 


securi ty_user .securi ty_user_id " + 


asc, i tenutext. text__seq asc "; 

} 


else if (doUDFTextQuery){ 

doReleaseUdfTextQuery = false; 

if (IdoPQuery && ! doUDFTextQuery) pResults = new 

i nudf Criteria = incriteria. toStringO ; 

udfTextSqlString = " select i temjtext . i tem_i d " + 

udf.name udf^name " + 
iterrutext.text TEXT " + 
item_text.text_seq TEXT_SEQ " + 
i tem_text .id_seq + problemUdfTextKey + 
item_text . timestamp TIMESTAMP " + 
i terrutext. user_id USER_ID " + 
security_user.fi rst_name FIRST_NAME " + 
securi ty_user. last_name LAST_NAME " + 
securi ty_user. email EMAIL " + 
from securi ty__user, udf, iterrutext " + 
where i terrutext . i tem_i d in " + 


and udf.name = ? " + 
and item_text . user_id = 

and udf.udf_id = i tem_text.udf_id " + 

order by item_text.item_id, i tem_text.id_seq 


Z.probe(" udfTextSqlString " + udfTextSqlString); 
Z.probe(" inudfcri teria. toStringO " + 
i nudf Cri te ri a . tost ri ng () ) ; 

tempUdfHash = new HashMapQ; 
tempTextList = new ArrayListO; 
tempTimestampList = new ArrayListO; 
tempUserList = new ArrayListO; 

// PROCESS ALL THE MULTI_VALUE UDFS 

// 

int udfsize = 0; 

if (doUDFTextQuery) udfsize = udf Text Fields. si ze () ; 
else udfsize = releaseudfTextFields.sizeO ; 

for (int i = 0; i < udfsize; i++) { 


it it 


ii ii 


tempUdfHash = new HashMapO; 
pKey = ""; 
pKeyPrev = 
ptKeyPrev = 
udfText .setLength(O) ; 
udf Timestamp = 
udf User - Ml ' ; 
udf Name = "": 


it it 
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= false; 


gotHash 

if (doUDFTextQuery) udfName = (string) 

udfTextFi elds. get (i ) ; 

else if (doReleaseudfTextQuery) udfName = (String) 

rel easeudf Text Fi el ds . get (i ) ; 

Z.probe( M PROCESSING TEXT UDF with udfName = " + 

udfName) ; 

if (udfstmt != null) udfstmt . close() ; 

//z.probe("RPT:ln Report .GetSelect - udfTextSql string "+udfTextSql String) ; 

udfstmt = conn. prepareStatement(udfTextsql String) ; 

// Bind the block of problem IDs and then bind UDF Name & Execute the query 

// 

if (doUDFMultiQuery){ 

for (int k = 0; k < sortedKeys.sizeO ; k++) 
udfstmt .setst ring (k + 1, (String) 

sortedKeys .get(k)) ; 

udfstmt. setstring(sortedKeys.size() + 1, udfName); 
else{ 

for (int k = 0; k < releaseKeys.size() ; k++) 
udfstmt. setstring(k + 1, (String) 

releaseKeys.get(k)) ; 

udfstmt. setString(releaseKeys.size() + 1, udfName); 

} 

udfRs = udfstmt .executeQueryO ; 

// Process the result rest 

// 

while (udfRs.nextO) { 

// To compare to the last processed_value 

// _ 

udfTextPrev = udfText. tost ring () ; 
udfTimestampPrev = udfTimestamp; 
udfUserPrev = udfuser; 
udfNamePrev = udfName; 
pKeyPrev = pKey; 
ptKeyPrev = ptKey; 

// Get the keys 

// 

if (doUDFMul tiQuery) pKey = 
udfRs.getString(PROBLEM_KEY) ; // the problem id 

else pKey = udf Rs . getstri ng ("PROBLEM_RELEASE_lD") ; 

// the release id 

ptKey = udfRs.getstring(problemudfTextKey) ; // the 
item_text key (non-unique by itself) 

udfName = udfRs.getString("UDF_NAME") ; 

//Z . p robe ( " RPT : = ! = !==!==! = ! ======= ! ================ \ ============ = i ============= I ===== 

===== | ======================") ; 

//Z. probe("RPT:gotHAsh = " +gotHash +" » processing " + udfName + " (pKey = " + 
pKey + ") (pKeyPrev=" +pKeyPrev + ") (ptKey=" +ptKey + ")"); 
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/* Completed processing a problem_id - each problem (pKey) has lists of comment 
fields 

:::;/ 


if (/*!pKey. equal s(pKeyPrev) && */! gotHash) { 
/* Add to the current HashMap if its there 

*/ 

if (!pKeyPrev.equalslgnoreCase(" M ) && ((tempobj 

= udf Item. get (pKeyPrev)) != null)) { 

tempUdfHash = (HashMap) tempobj; 
//Z.probe( M RPT:++FOUND HASHMAP FOR probeLM *'+ pKeyPrev + ":'' + tempUdfHash); 

} else { 

tempUdfHash = new HashMapO; 
//z.probe("RPT:++NOT FOUND HASHMAP FOR probeLM "+ pKeyPrev + " : " + tempUdfHash); 

gotHash = true; 
getNewList = true; 

/* else if ( ((tempobj = udfltem.get(pKeyPrev)) != null) && IgotHash ){ 
tempUdfHash = (HashMap) tempobj ; 

//Z.probe("RPT: FOUND HASHMAP FOR probeLM "+ pKeyPrev + " : " + tempUdfHash); 
gotHash = true; 
getNewList = true; 

else{ 

//Z.probe("RPT: ALREADY HAVE HASHMAP FOR probeLM "+ pKeyPrev + " : " + tempUdfHash); 

V 

if (getNewList) { 
/* Use the current list if you've already processed that UDF 

V 


_text) ) != null) 


_TIMESTAMP)) != null) 


_USER)) != null) 


if ((tempobj = tempUdfHash. get (udf NamePrev + 

tempTextList = (ArrayList) tempobj; 
else tempTextList = new ArrayListO; 

if ((tempobj = tempUdfHash. get (udf NamePrev + 

tempTimestampList = (ArrayList) tempobj; 
else tempTimestampList = new ArrayListO; 

if ((tempobj = tempUdfHash. get (udf NamePrev + 

tempUserList = (ArrayList) tempobj; 
else tempUserList = new ArrayListO; 
getNewList = false; 

} 

/* Merge all 4k blocks - each comment has its own ptKey 

*/ 

tempResult = udfRs.getString("TEXT") ; 
if ( tempResult != null && 

integer. parselnt (udf Rs.getString("TEXT_SEQ")) > 

1) 

tempResult = 
tempResul t . subst ri ng (z . TEXT_OVE RLAP) ; 
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if ( ptKey. equal s(ptKeyPrev) && 

if (tempResult == null) 

udfText . append(emptystri ngSpacer) ; 
else if (isTextOutputTypeO) 

udfText . append (thi s . i sTextOutputType () 

? tempResult 


TextManager . converturl (getPri ntabl eResul t (tempResul t))) ; 

else{ 
if 

("PRINTTEXT" . equal slgnoreCase(ddeDi spl ayType)) { 

udfText . append (thi s . i sTextOutputType () 

? tempResult 


getPri ntabl eResul t (tempResul t) ) ; 


} 

else{ 


udfText . append (thi s . i STextOutputType () 

? tempResult 


Tex t «a„ ager .c„nverturl( 0 etPnnt a ble R esun( t e m p R es„ 1 «)) ; 

} 

} 

else{ 
if 

("PRINTTEXT" .equal sIgnoreCase(ddeDi spl ayType)) 

udfText = new 

stri ngBuffer(this. isTextOutputTypeO 


? tempResult 


getPri ntableResul t(tempResul t)) ; 


else 


Stri ngBuffer(this . isTextOutputTypeO 


udfText = new 


? tempResult 


TextManager . converturl (getPri ntableResul t(tempResult))) ; 

String tempDate = formatDateString( dbt, 
su, 

Conve rt . toCal endar (udf Rs . getTi mestamp("TlMESTAMP") ) , 

emptyStri ngSpacer) ; 
udfTimestamp = getPri ntabl eResul t (tempDate) ; 

udfuser = 

thi s . getEmai 1 Li nk(udf Rs . getstri ng ("USER_ID") , 

udf Rs . getstri ng ("FIRST_NAME") , 
udf Rs . getstri ng ("LAST_NAME") , 
udfRs.getString("EMAIL")) ; 

// a new item_text_id means a new comment so add the last comment info 

// 


! pKey . equal s (pKeyPrev) ) 


if (! ptKeyPrev.equals("") 

&& (! ptKey. equal s (ptKey Prev) || 
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&& gotHash) { 

tempTextList. add(udfTextPrev) ; 

tempTi mes tampLi st . add (udf Ti mestampPrev) ; 

tempUserLi st . add (udf UserPrev) ; 

// if (IpKey. equal s(pKeyPrev)){ 

tempudf Hash. put (udf NamePrev + _TEXT , 

tempTextList) ; 

tempudf Hash, put (udf NamePrev + __TI ME STAMP, 

tempTi mestampLi st) ; 

tempudf Hash. put (udf NamePrev + _USER, 

tempuserList) ; 

udf Item. put(pKeyPrev, tempUdfHash) ; 
//z.probe( H RPT:new ptkey = M + ptKey +" » pKey = "+pKey+" processed " + udf Name + " 
udfltem. put(pKeyPrev = +pKeyPrev + > " + tempUdfHash; ; 

gotHash = false; 

// } 

} 

} // end while rs 

// track the distinct UDF Names 

if (distinctudf Names. get (udf Name) == null) { 
disti nctudf Names. put (udf Name, "") ; 
distinctUdfNameList.add(udfName + _TEXT) ; 
disti nctudf NameLi st.add(udf Name + _TIMESTAMP) ; 
disti nctudf NameLi st.add(udf Name + _USER) ; 

} 

/* Deal with the last record 

*/ 

if (pKey.equals(pKeyPrev) && gotHash) { 

//z.probe("RPT: DOING LAST RECORD !!!!»> tempUdfHash: " +tempudf Hash) ; 

/* Use the current list if you've already processed that UDF 

*/ 

if ((tempobj = tempudf Hash. get (udf Name + _TEXT) ) != 

null) 

tempTextList = (ArrayList) tempobj; 
else tempTextList = new ArrayListO; 

if ((tempobj = tempudf Hash. get (udf Name + 

tempTi mestampLi st = (ArrayList) tempobj; 
else tempTi mestampLi st = new ArrayListO; 

if ((tempobj = tempudf Hash. get (udf Name + _USER)) != 

tempuserList = (ArrayList) tempobj; 
else tempuserList = new ArrayListO; 
getNewList = false; 

tempTextLi st . add (udf Text . tost ri ng () ) ; 
tempTi mestampLi s t . add (udf Ti mes tamp) ; 
tempUserLi st . add(udf User) ; 

tempUdfHash. put (doReleaseUdfTextQuery ? 

"PROBLEM_RELEASE_ID" : PROBLEM^KEY^ALIAS , pKey) ; 

tempUdfHash. put (udf Name + _TEXT, tempTextList); 

tempUdfHash. put (udf Name + _TI ME STAMP , 

tempTi mestampLi s t) ; 
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tempUdfHash. put (udf Name + _USER, tempUserLi st) ; 
udfltem. put(pKey, tempUdfHash); 
gotHash = false; 

} 

else { 

// Add to the current HashMap if its there 

if ((tempobj = udf Item. get (pKey)) != null) 

tempUdfHash = (HashMap) tempobj ; 

else tempUdfHash = new HashMapO; 
/* Use the current list if you've already processed that UDF 

V 


null) 


_TIMESTAMP) ) != null) 


null) 


if ((tempobj = tempudf Hash. get (udf Name + _TEXT) ) != 

tempTextList = (ArrayList) tempobj; 
else tempTextList = new Arrayl_ist(); 

if ((tempobj = tempUdfHash. get (udf Name + 

tempTimestampList = (ArrayList) tempobj; 
else tempTimestampList = new ArrayList(); 

if ((tempobj = tempudf Hash. get (udf Name + _USER)) != 

tempUserLi st = (ArrayList) tempOb j ; 
else tempUserList = new ArrayListQ; 
getNewList = false; 

tempTextLi st . add (udf Text . tost ri ng () ) ; 
tempTi mes tampLi st . add (udf Ti mes tamp) ; 
tempUserLi st. add(udfuser) ; 

tempUdfHash. put (doReleaseUdfTextQuery ? 

M PROBLEM_RELEASE_ID" : PROBLEM_KEY_J\LIAS, pKey) ; 

tempUdfHash. put (udf Name + _TEXT, tempTextList); 
tempUdfHash. put(udfName + _TIMESTAMP, 

tempTimestampList) ; 

tempUdfHash. put (udf Name + _USER, tempUserList); 

udfltem. put(pKey, tempUdfHash) ; 
gotHash = false; 

//Z.probe("RPT: FINAL RECORD new ptkey» processed " + udfName + " 
udfltem. put(pKeyPrev = " +pKey + " , > " + tempUdfHash); 
//Z.probe("RPT:»» udfltem is : " + udfltem); 

}// end while 

// Loop through the UDF text results and append each one 

// to the pRows name/value hashmap in pResults given a problem id 


HashMap udfvals = new HashMapO; 
String udfLayoutName = ""; 
Iterator taglt = null; 

ArrayList emptyList = new ArrayListO; 

emptyLi st . add(thi s . emptyStri ngSpacer) ; 


// pQuery already run 
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&& doPRQuery)) { 


prResul ts) ; 


// all ids in problem 


if ((doUDFTextQuery && doPQuery) || (doReleaseUdfTextQuery 

Z.probe( M « Adding to existing results » "); 
Z.probe("« Existing results - prResults : " + 

Z.probe( M « Existing udfltem - udfltem : " + udf Item) ; 
Iterator it = null ; 

if (doUDFMul tiQuery) it = pResults. keyset () .iterator () ; 
else it = prResults. keySet() .iterator() ; 

ArrayList multi Rel eases = null; 

ArrayList multiList = null; 

ArrayList tmpLst = null; 

StringBuffer multi Sb = new StringBufferQ ; 


String prKey = 


ii ii 


pResults. get (pKey) ; 


while (it.hasNextO) { 

pRows = new HashMapO; 
pKey = (String) it.next(); 

if (doUDFTextQuery) pRows = (HashMap) 

else{ 

pRows = (HashMap) prResul ts. get (pKey) ; 
multiList = new ArrayListQ; 


// 
// 

pRows) ; 

// 

udfltem) ; 


Z.probe(" The results pKey is : " + pKey) ; 
Z.probe(" This pKey has tne following hash : 


ii 


z.probe(" The udfltem hashmap is udfltem : " + 


// need to loop through each of the releases for any given problem Key pKey 


pROWS . get ("PROBLEM_RELEASE_ID") ; 


if (doReleaseUdfTextQuery) { 

multi Rel eases = (ArrayList) 


== null) { 


for (int i = 0; i < mul ti Rel eases. si ze() ; i++){ 
prKey = (String) mul ti Rel eases. get (i ) ; 

if ((udfvals = (HashMap) udfltem. get(prKey)) 


di sti nctudf NameLi st . si ze () ; j++) 
distinctUdfNameList.get(j) , emptyList) ; 
// pRows.put(this.problemKeyAlias, prKey) ; 

} 

else { 
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for (int j = 0; j < 
pRows. put ((String) 


distinctUdfNameList.sizeQ ; j++) { 
di sti nctudf NameLi st . get ( j ) ; 
null) 

emptyList) ; 

udfval s . get (udf LayoutName) ; 

tmpLst.sizeO ; y++){ 

mul ti sb . append (mul ti Udf Separator) ; 

multisb. append ( (St ri ng)tmpl_st . get(y)) ; 

mul ti Sb. tost ring ()) ; 
mul ti Li st) ; 

// pRows.put(problemKeyAlias, prKey); 


rt. java 

for (int j = 0; j < 

udf LayoutName = (String) 
if (udf Vals. get (udf LayoutName) == 

pRows . put (udf LayoutName , 
else{ 

tmpLst = (ArrayList) 
//tmpD 

multisb. setLength(O) ; 
for (int y = 0; y < 

if (y >0) 

} 

mul ti List. add( 
pRows . put (udf LayoutName , 

} 

}// end for 


} 

prResults.put(pKey, pRows) ; 

} 

else{ 

if ((udfvals = (HashMap) udfltem.get(pKey)) == 

null) { 

for (int i = 0; i < 

di sti nctudf NameLi st . si ze() ; i++) 

pRows . put((stri ng) 

di sti nctudf NameLi st. get (i) , emptyList) ; 

pRows . put (PROBLEM_KEY_ALIAS , pKey) ; 

} 

else { 

for (int i = 0; i < 


di sti nctudf NameLi st. si ze() ; i++) { 
di sti nctudf NameLi s t . get (i ) ; 


udfval s . get (udf LayoutName)) ; 


udf LayoutName = (String) 

if (udf vals. get (udf LayoutName) == null) 
pRows . put (udf LayoutName , emptyLi s t) ; 

else 

pRows . put (udf LayoutName , (Ar rayLi st) 
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} 

pROWS.put(PROBLEM_KEY_J\LIAS, pKey) ; 


} 


} 


} 


} 


pResults.put(pKey, pRows) ; 


// Never ran p_query use sorted keys 

else { 

Z.probe("« Adding to new results » "); 

for (int k = 0; k < sortedKeys . si ze() ; k++) { 


{ 


distinctUdfNameList.get(i) , emptyList) ; 


pRows = new HashMapO; 

pKey = (String) sortedKeys. get (k) ; 

if ((udfvals = (HashMap) udtltem. get (pKey)) == null) 


for (int i =0; i < distinctUdfNameList . size() ; 
pRows . put ((stri ng) 


di sti nctudf NameLi st . get (i ) ; 


udfval s . get (udf LayoutName)) ; 


} 


} 


} 


} 


pROWS . put (PROBLEM_KEY^ALIAS , pKey) ; 

} else { 

for (int i = 0; i < distinctUdfNameList. size() ; 


udf LayoutName = (String) 

if (udfvals. get(udf LayoutName) == null) 
pRows . put (udf LayoutName , emptyLi st) ; 

else 

pRows . put (udf LayoutName , (ArrayLi st) 

} 

pROWS.put(PROBLEM_KEY_ALIAS, pKey) ; 

} 

if (doUDFMul tiQuery) pResul ts . put (pKey , pRows) ; 
else prResults.put(pKey, pRows) ; 


// 
// 
/* 

pROWS 

pKey = 
pRows 


} 


} 


while (it.hasNextO) { 
= new HashMapO ; 

(String) it.next(); 
= (HashMap) pResul ts.get(pKey) ; 


if ((udfvals = (HashMap) udfltem.get(pKey)) == null) { 

for (int i =0; i < distinctUdfNameList. si ze () ; i++) 
pRows.put((String) distinctUdfNameList .get (i) , emptyList) ; 

pRows.put(this.problemKeyAlias, pKey) ; 

} 
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else { 

for (int i = 0; i < distinctudfNameList.size() ; i++) { 
udf LayoutName = (String) distinctudfNameList.get(i) ; 
if (udfvals. get (udf LayoutName) — null) 
pRows . put (udf LayoutName , emptyLi st) ; 
else 

[j>Rows . put (udf LayoutName , (ArrayLi st) udfval s . get (udf LayoutName)) ; 
[DRows . put (probl emKeyAl i as , pKey) ; 
Results. put (pKey, pRows) ; 

} 

/// Never ran p_query use sorted keys 


else { 

for (int k = 0; k < sortedKeys.size() ; k++) { 

pRows = new HashMapO; 

pKey = (String) sortedKeys.get(k) ; 

if ((udfvals = (HashMap) udfltem.get(pKey)) == null) { 
for (int i = 0; i < distinctUdfNameList.size() ; i++) 
pRows . put ( (St ri ng) di sti nctudf NameLi st . get (i ) , emptyLi st) ; 

Rows . put (thi s . probl emKeyAl ias , pKey) ; 

else { 

for (int i = 0; i < disti nctudfNameList .size() ; i++) { 

udf LayoutName = (String) di sti nctudfNameList. get (i ) ; 
if (udfvals. get (udf LayoutName) == null) 
pRows . put (udf LayoutName , emptyLi st) ; 
else 

|DRows . put (udf LayoutName , (ArrayLi st) udfval s . get (udf LayoutName) ) ; 
^Rows. put (probl emKeyAl ias, pKey) ; 
Resul ts . put (pKey , pRows) ; 

} 

V 

catch (Exception e) { 

Z. log .writeToLog (Log. ERROR, "Error in method getSelect:" + e) ; 
//Errorwri ter .wri te(e, ErrorWri ter . LOG) ; 

throw e; 
} finally { 

if (udfstmt != null) udfStmt.close() ; 

Z. log .wri teToLog(Log . DEBUG3 , thi s , 
"AAAAReport.getSelect.doUDFTextQuery = true udfTEXTStatement closed"); 
//Z. probe( M RPT:ln Report .GetSelect - if doUDFTextQuery = true --> pResults : "+ 
pResul ts) ; 

} 

} 

I ft * ************************ 

//* Execute the query -- MULTI ROW UDFs -- MULTI UDFS 

I ^/************************************************************************** 

if (doUDFMultiQuery | | (doReleaseUdfMul tiQuery && doPRQuery)) { 
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boolean gotHash = false; 
boolean getNewList = false; 
int loopcnt = 0; 
Object tempobj = null; 


»i »» . 
i 

ii H 

rig = 

ii M 


pKey = 

String udfMultiSql String = 
String tempResult = 
String udfName = ""; 
String udfListTi tie = ""; 
String udfListld = ""; 
String pKeyPrev = ""; 
string udfListTi tlePrev = "" ; 
String udfNamePrev = 


Iterator udfRowIt = null; 

HashMap tempUdfHash = null; 
ArrayList tempTi tleList = new Arrayl_ist(); 
ArrayList templdList = new ArrayListO; 
HashMap distinctudf Names = new HashMapO; 
ArrayList distinctUdfNameList = new ArrayListO; 


HashMap udfltem = new HashMapO; 
String inudfcriteria = "" ; 
String stdUdfMul ti Sql = ; 

boolean multiudf Parents [] = 
{doUDFMul ti Query , doRel easeudf Mul ti Que ry} ; 

try { 

z.probe( M RPT:ln Report . GetSel ect - doUDFMul tiQuery") ; 

// Process UDFS for each of the different Parent Tables (currently Items & 
Releases) 

// 


for (int x = 0; x < multiudf Parents. length; x++){ 

if (! multiudf Parents [x]) continue; 

if ( X == 0){ 

doUDFMul tiQuery = true; 

doRel easeudf Mul tiQuery = false; 

} 

if (x == 1){ 

doUDFMul tiQuery = false; 
doReleaseudfMul tiQuery = true; 

} 

// Loop through each of the UDF's individually. Append each one to 
// pRows in pResults given a problem id 

if (doReleaseudfMul tiQuery) { 

if (IdoPRQuery && ! doReleaseudfMul tiQuery) prResults 

new HashMapO ; 

inudfcriteria = rlnCri teri a. tostri ng() ; 


stdUdfMul tiSql = 

" select ig.item2_id " + PROBLEM_KEY + 

iu.item_id problem_release_id , " + 
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u.name UDF_NAME, ul. title TITLE " + 
from iterruudf iu, udf u, udf_list ul , 

where iu.item_id in " + inudfcriteria + 
and u.name = ? " + 
and u.udf_id = iu.udf_id " + 
and ig.iteml__id = iu.iterruid " + 
and ul .udf_list_id = iu.udf_list_id " + 
order by ig.item2_id, iu.item_id "; 

} 

else if (doUDFMul ti Query) { 

if (IdoPQuery && ! doUDFMultiQuery) pResults = new 

inudfcriteria = incriteria. toStringC) ; 

stdudfMultiSql = 

select iu.item_id " + PROBLEM_KEY + " , " 
u.name UDF_NAME, ul. title TITLE " + 
from item_udf iu, udf u, udf_list ul " + 
where iu.item_id in " + inudfcriteria + 
and u.name = ? " + 
and u.udf_id = iu.udf_id " + 
and ul .udf_list_id = iu.udf_list_id " + 
order by iu.item_id " ; 


Z . p robe (" A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A 

z.probe(" doing udf _ : " + stdudfMultiSql); 

Z . probe (" A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A. A 

tempUdfHash = new HashMap(); 
tempTi tleList = new ArrayList(); 


// PROCESS ALL THE MULTI_VALUE UDFS 

// 

int udf Size = 0; 

if (doUDFMultiQuery) udfsize = udfMulti Fields. sizeQ ; 
else udfsize = releaseUdfMul ti Fields. size() ; 

for (int i =0; i < udfsize; i++) { 

gotHash = false; 
tempUdfHash = new HashMapO; 
udfListTitle = ""; 

if (doUDFMultiQuery) udf Name = (string) 

udfMulti Fields. get (i) ; 

else if (doReleaseUdfMultiQuery) udf Name = (string) 
rel easeUdf Mul ti Fi el ds . get (i ) ; 

// allow override of standard sql statment with customized. 

udfMul tisqlstring = Z. userCustom. reportSetUdfMul tiSql 

(udf Name , stdudf Mul ti Sql , 

problem_key, i nCri teri a . tost ri ng () ) ; 
Z.probe("DOING MULTl UDF _ got udfMulti Sql string == 

+udfMul tisqlstring) ; 

if (udfstmt != null) udfstmt . close() ; 
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udfstmt = conn. prepareStatement(udfMultiSql String) ; 
/* Bind the block of problem IDs and then bind UDF Name & Execute the query 

: v 

if (doUDFMultiQuery){ 

for (int k = 0; k < sortedKeys.sizeO ; k++) 
udfstmt .setstring(k + 1, (String) 

sortedKeys.get(k)) ; 

udfstmt. setString(sortedKeys.size() + 1, udf Name) ; 

} 

else{ 

for (int k = 0; k < releaseKeys.size() ; k++) 
udfstmt .setstring(k + 1, (String) 

releaseKeys.get(k)) ; 

udfstmt. setString(releaseKeys.size() + 1, udf Name) ; 

} 

Z.probe("DOlNG MULTI UDF _ About to execute 
udfMultiSqlstring = " + udfMul tiSql String) ; 

udfRs = udfstmt .executeQueryO ; 

// Process the result rest 

// 

while (udf Rs. next ()) { 

// To compare to the last processed_value 

udfListTi tlePrev = udfListTi tie; 
udfNamePrev = udf Name; 
pKeyPrev = pKey; 

// Get the keys 

// 

if (doUDFMul tiQuery) pKey = 
udfRs.getstring(PROBLEM_KEY) ; // the problem id 

else pKey = udfRs .getstri ng("PROBLEM_RELEASE_ID") ; 

// the release id 

udf Name = udfRs.getString("UDF_NAME") ; 

//Z.probe("RPT: » processing udf Name " + udfName + " (pKey = " + pKey + ") 
(pkeyPrev = "+ pKeyPrev +") "); 

// Completed processing a problem_id - each problem (pKey) has lists of comment 
fields 

// _ 

udfListTi tie = 

(get Pri ntabl eResul t (udf Rs . getstri ng ("Ti tie"))); 

if (IpKey. equal s(pKeyPrev) && IgotHash) { 


// Add to the current HashMap if its there 

// 

if (!pKeyPrev.equalslgnorecase(" M ) && ((tempobj 
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= udfltem.get(pKeyPrev)) != null)) { 


templidfHash = (HashMap) tempOb j ; 

FOR DrobeLM *'+ pK 


////Z . probe("RPT: GOTHASH : "+ gotHash+" FOUND HASHMAP FOR probeLM "+ pKeyPrev + : 
" + tempudfHash) ; 

} 

else { 

tempudfHash = new HashMapO; 
////z.probe( M RPT: GOTHASH :"+ gotHash+" NOT FOUND HASHMAP FOR probeLM "+ pKeyPrev + 
" : " + tempudfHash); 

} 

gotHash = true; 
getNewList = true; 

else if (((tempobj = udfltem. get(pKeyPrev)) != null) 

&& ! gotHash) { 

tempudfHash = (HashMap) tempobj; 
////Z. probe("RPT: GOTHASH :"+ gotHash+ " FOUND HASHMAP FOR probeLM "+ pKeyPrev + " 
: " + tempudfHash) ; 

gotHash = true; 
getNewList = true; 

// else if (gotHash) { 

// //Z.probe("RPT: GOTHASH :"+ gotHash+" ALREADY GOT HASHMAP FOR probeLM "+ 
pKeyPrev + " : " + tempudfHash); 

// } 

if (!pKeyPrev.equals("")) { 

//z. probe( n RPT: ADDING udfList TitlePRev for pkeyPrev: "+ pKeyPrev + " - " + 
udfListTitlePrev ); 

tempTi tl eLi s t . add (udf Li stTi tl ePrev) ; 

/* a new problem_id means a new array! ist 

*/ 

if (! pKey. equals (pKeyPrev) && gotHash) { 

tempudfHash . put (udf NamePrev , tempTi tl eLi st) ; 

udfltem. put(pKeyPrev, tempudfHash) ; 
gotHash = false; 

tempTi tleList = new ArrayList(); 
////Z.probe( M RPT:NOW SEt GOTHASH TO " + gotHash +" new pKey = "+pKey+" processed " 
+ udf Name + " udfltem. put (pKeyPrev = " +pKeyPrev + " , > " + tempudfHash); 

} } 
} // end while rs 

// track the distinct UDF Names 

if (distinctudf Names. get (udf Name) == null) 
distinctUdfNameList . add(udfName) ; 

//Z.probe("RPT: FINAL results pKeyPrev -"+ pKeyPrev + " pKey-" + pKey + " 
gotHash-"+gotHash) ; 

// Deal with the last record 

// 

if (pKey.equals(pKeyPrev)) { 

if (! gotHash) tempudfHash = new HashMapO; 
tempTi tl eLi st . add (udf Li stTi tl e) ; 
tempudfHash. put ( doReleaseUdfMulti Query ? 

"PROBLEM_RELEASE_ID" : PROBLEM_KEY_ALIAS , pKey) ; 

tempudfHash. put (udf Name, tempTi tleList) ; 
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udfltem. put(pKey, tempudfHash) ; 


else { 

// Add to the current HashMap if its there 

// 


tempudfHash = (HashMap) tempob j ; 


" PROBLEM_RELEASE_ID" 


if ((tempobj = udfltem.get(pKey)) != null) 
else tempudfHash = new HashMapO; 
tempTi tleList = new Arrayl_ist(); 
tempTi tl eLi st . add (udf Li stTi tl e) ; 
tempudfHash. put ( doReleaseUdfMul tiQuery ? 

PROBLEM_KEY_ALIAS , pKey) | 

tempudfHash. put (udf Name, tempTi tleList) ; 


} 


udfltem. put(pKey, tempudfHash) ; 


gotHash = false; 

tempTi tleList = new ArrayList(); 

//Z. probe ("RPT: FINAL RECORD new pkey» processed " + udfName + " 
udfltem. put(pKeyPrev = " +pKey + > + tempudfHash); 
//z. probe("RPT:»» udfltem is : " + udfltem); 

}// end for 

/* Loop through the UDF text results and append each one 

to the pRows name/value hashmap in pResults given a problem id 

*/ 

HashMap udfvals = new HashMapO; 
String udf LayoutName = ""; 
Iterator taglt = null; 

ArrayList emptyList = new ArrayList(); 

emptyLi st . add(thi s . emptySt ri ngSpacer) ; 


// pQuery already run 

// 


&& doPRQuery)) { 


prResul ts) ; 

// all ids in problem 


Z.probe(" About to add multi-udf to results " ); 

if ((doUDFMul tiQuery && doPQuery) || (doReleaseUdfMultiQuery 

Z.probe("« Adding to existing results » ") ; 
Z.probe("« Existing results - prResults : " + 

Z.probe("« Existing udfltem - udfltem : " + udfltem); 

Iterator it = null ; 

if (doUDFMul tiQuery) it = pResul ts . keyset (). iterator () ; 
else it = prResults. keyset() .iterator() ; 

ArrayList mul ti Rel eases = null; 
ArrayList multiList = null; 
ArrayList tmpLst = null; 

StringBuffer multisb = new Stri ngBuff er() ; 
String prKey = "" ; 
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while (it.hasNextO) { 

pRows = new HashMapO; 
pKey = (String) it.next(); 

if (doUDFMulti Query) pRows = (HashMap) 

else{ 

pRows = (HashMap) prResul ts.get(pKey) ; 
multiList = new ArrayList(); 

} 


// 
// 

pRows) ; 

// 

udf Item) ; 


z 
z 


. probe (" The results pKey is : " + pKey) ; 
. probe(" This pKey has the foil 


owing hash : 


Z.probe(" The udfltem hashmap is udfltem : " + 


PROWS . get ("PROBLEM_RELEASE_ID M ) ; 


if (doReleaseUdfMul tiQuery){ 
multi Releases = (ArrayList) 


== null) { 


for (int i = 0; i < mul ti Releases. si ze () ; i++){ 
prKey = (string) multi Releases. get (i ) ; 

if ((udfvals = (HashMap) udfltem. get(prKey)) 


di sti nctudf NameLi st . si ze () ; j ++) 
distinctUdfNameList.get(j) , emptyList) ; 
// pRows.put(this.problemKeyAlias, prKey) ; 

} 


for (int j = 0; j < 
pRows. put ((String) 


else { 


di sti nctudf NameLi st. si ze() ; j++) { 
di sti nctudf NameLi st . get ( j ) ; 
null) 

emptyList) ; 


udf val s . get (udf LayoutName) ; 


tmpLst.sizeO ; y++){ 

mul ti sb . append (mul ti Udf Separator) ; 

mul ti Sb . append ( (St ri ng) tmpLst . get (y)) ; 


for (int j = 0; j < 

udf LayoutName = (String) 

if (udfvals. get (udf LayoutName) == 

pRows . put (udf LayoutName , 
else{ 

tmpLst = (ArrayList) 

mul tisb. set Length (0) ; 
for (int y = 0; y < 

if (y >0) 


} 


z . 1 og . wri teToLog (z . 1 og . DEBUG5 , "ABOut to append multisb to the release multiUDF " + 
multi Sb. tost ring ()) ; 
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multi List. add ( 

multisb. tost ring ()) ; 

pRows . put (udf LayoutName , 

mul tiList) ; 

} 

}// end for 

// pRows. put (p rob! emKeyA "lias, prKey); 


} 

prResul ts . put(pKey , pRows) ; 

} 

else{ 

if ((udfvals = (HashMap) udfltem.get(pKey)) == 

null) { 

for (int i = 0; i < 

di sti nctudf NameLi st . si ze() ; i ++) 

pRows . put((stri ng) 

di sti nctudf NameLi st. get (i) , emptyList) ; 

pROWS. put(PROBLEM_KEY_JU_IAS, pKey) ; 

} 

else { 

for (int i =0; i < 


di sti nctudf NameLi st. si ze() ; i++) { 
di sti nctudf NameLi st . get (i ) ; 


udfvals .get (udf LayoutName)) ; 


} 

} 

} 


udf LayoutName = (String) 

if (udfvals. get (udf LayoutName) == null) 
pRows . put (udf LayoutName , emptyLi s t) ; 

el se 

pRows . put (udf LayoutName, (ArrayList) 

pROWS.put(PROBLEM_KEY_ALIAS, pKey) ; 

pResults.put(pKey, pRows) ; 


// Never ran p_query use sorted keys 

else { 

Z.probe( M « Adding to new results » "); 

for (int k = 0; k < sortedKeys.size() ; k++) { 

pRows = new HashMapO ; 

pKey = (String) sortedKeys . get (k) ; 

if ((udfvals = (HashMap) udtltem. get (pKey)) == null) 

for (int i = 0; i < disti nctudf NameLi st. si ze() ; 
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pRows . put((stri ng) 


i++) { 


di sti nctudf NameLi st . get (i ) ; 


udfvals .get(udfLayoutName)) ; 


} 


} 


} 


} 


pRows . put (PROBLEM_KEY_ALIAS , pKey) ; 
} else { 

for (int i =0; i < disti nctudf NameLi st. si ze() ; 


udfLayoutName = (String) 

if (udfvals. get (udfLayoutName) == null) 
pRows . put (udfLayoutName , emptyLi st) ; 

else 

pRows . put (udfLayoutName , (ArrayLi st) 

} 

pROWS.put(PROBLEM_KEY_J\LIAS, pKey) ; 

} 

if (doUDFMultiQuery) pResults.put(pKey, pRows) ; 
else prResul ts . put(pKey , pRows) ; 


catch (Exception e) { 

Z. log. writeToLog(Log. ERROR, "Error in method getselect:" + e) ; 
//Errorwri ter . wri te (e , ErrorWri ter . LOG) ; 

throw e; 
} finally { 

if (udfstmt != null) udfstmt . close() ; 
z . 1 og . wri teToLog (Log . DEBUG , thi s , 
"AAAAReport. getselect. doUDFMultiQuery = true udfMULTlStatement closed"); 
//Z. probe("RPT:ln Report .Getselect - if doUDFMultiQuery = true --> pResults : "+ 
pResul ts) ; 

} 

} 

/***************************************************************** 

* SORT THE RESULTS BASED ON THE ORDER OF THE MASTER LIST 

* — create lists for the multi valued results 

* 

****************************************** 

HashMap nameValues = null; // the final hashmap for this problem id — 
gets pmNameValues & prNameValues appended to it 

HashMap pmNameValues = null; 
HashMap prNameValues = null; 
HashMap paNameValues = null; 
HashMap rgNameValues = null; 

HashMap prMulti Lookups = null 

HashMap pmMulti Lookups = null 

HashMap paMulti Lookups = null 

HashMap rgMulti Lookups = null 

ArrayList latestMultiList = null; 
ArrayLi st tempList = null; 
Object tmpobj = null; 
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Iterator pi = null ; 

Iterator pmi = null; // problem module iterator for name/value pairs i 

a record 

Iterator pri = null; // problem release iterator for name/value pairs 

a record 

Iterator pai = null; // attachment iterator for name/value pairs in a 

record 

Iterator rgi = null; // relationship group iterator for name/value pai 

in a record 

String sortedld = ; 

tempAlias = ""; 
boolean isList = false; 

/* Combine the results given the SORTED ID combine the name/value hashMap 

1 V 

for (int k = 0; k < sortedKeys . si ze() ; k++) { 

namevalues = new HashMapO; 
pmNameValues = new HashMapO 
prNameValues = new HashMapO 
paNameValues = new HashMapO 
rgNameValues = new HashMapO 
prMulti Lookups = new HashMapO; 
pmMulti Lookups = new HashMapO; 
paMulti Lookups = new HashMapO; 
paMulti Lookups = new HashMapO; 

sortedld = (String) sortedKeys . get (k) ; 

/* Get the problem results back in the right order 

*/ 

tmpObj = null ; 

if ((pResults != null)) tmpObj = pResul ts . get (sortedld) ; 
if (tmpObj != null) 

namevalues = (HashMap) tmpObj ; 
else { 

for (int i = 0; i < problemFieldList.size() ; i++) { 
key = (string) problemFieldList .get(i) ; 
thisDDE = (DDEntry) (dictionaryFields.get(key)) ; 

ddeType = thisDDE.getType() ; 
ddeName = thisDDE.getNameO ; 

if (namevalues. get (ddeName) == null) { 
if (thisDDE.isMultipleValue() && 
! ddeName . equal slgnorecase (PROBLEM_KEY^ALIAS)) 

namevalues. put (ddeName, new ArrayListO) ; 
else if (ddeName . egual slgnoreCase(PROBLEM_KEY_ALlAS) ) 
nameval ues . put (ddeName , sortedld) ; 

else 

nameval ues . put (ddeName , emptyStri ngSpacer) ; 

} } 

} 

/* Process the Problem Module Results 


*/ 

if (doPMQuery) { 
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Z.probe( "ABOUT TO APPEND MODULE RESULTS TO FINAL RESULTS!! 

pmResults :" +pmResults); 

Z.probe( "pmResults. get( M +sortedld+") = " + 
pmResul ts . get (sortedld J ) ; 

if ((tmpobj = pmResults. get(sortedld)) != null) { // if there 
are results for this ID 

pmNameVal ues = (HashMap) tmpob j ; 
//z. probe ( "pmNameValues = " + pmNameVal ues) ; 
/* Merge the results 

*/ 

pmi = pmNameValues. keyset () .iterator() ; 
while (pmi . hasNext()) { 

isList = false; 

tempAlias = (string) pmi. next (); 

// check to see if its a list 

if ("Y" . equal slgnorecase((stri ng) 

pmDataAl i as . get (tempAl i as) ) 

&& ! tempAl i as . equal slgnoreCase(PROBLEM__KEY_ALlAS) ) 
nameVal ues . put (tempAl i as , (Array Li st) 

pmNameVal ues . get (tempAl i as) ) ; 

else 

nameVal ues . put(tempAlias , (Stri ng) 

pmNameVal ues . get (tempAl i as) ) ; 

} 

} // end if there are results 

/* If there are no results for this sorted ID, we still need to 
send back an empty. 

*/ 

else { 

for (int i = 0; i < moduleFieldList.sizeO ; i++) { 
key = (String) moduleFieldList .get(i) ; 
thisDDE = (DDEntry) (dictionaryFields.get(key)) ; 

ddeType = thisDDE.getType() ; 
ddeName = thisDDE.getName() ; 

if (nameVal ues. get (ddeName) == null) { 
if (thisDDE.isMultipleValue() && 
! ddeName. equal slgnoreCase(PROBLEM_KEY^U_lAS)) 

nameVal ues. put (ddeName, new ArrayListO) ; 
else if 

(ddeName. equal slgnoreCase(PROBLEM_KEY_ALIAS)) 

nameval ues . put (ddeName , sortedld) ; 

else 

nameVal ues . put (ddeName , emptyst ri ngSpacer) ; 

} } 

} 

} // end if doPMQuery 
/* Process the Problem Release Results 


*/ 


if (doPRQuery) { 

Z.probe( "ABOUT TO APPEND RELEASE RESULTS TO FINAL RESULTS!!"); 

Z.probe( "prResults !! == " +prResults); 
Z.probe( "prResults. get ("+sortedld+") = " + 
prResults .get (sortedld;) ; 
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if (Ctmpobj = prResults.get(sortedld)) != null) { // if there 
are results for this ID 

prNameValues = (HashMap) tmpobj ; 
//Z.probe( "prNameValues = " + prNameValues); 


// add the release multi-udfs to the prDataAlias list 

// 


for 


(int j = 0; j < rel easeudfMulti Fields. si ze() ; j++) 
prDataAlias. put(releaseUdfMulti Fields. get(j) , "Y") ; 


for (int j = 0; j < rel easeudf Text Fields. si ze () ; j++){ 

prDataAl i as . put (rel easeUdfTextFi el ds . get(j)+__TEXT, "y") ; 
prDataAl i as . put (rel easeUdfTextFi el ds . get ( j )+_USER , "Y") ; 

prDataAl i as. put (rel easeudf Text Fields. get ( j )+_TIMESTAMP , "Y") ; 

prDataAl i as . put (rel easeUdfTextFi el ds . get (j) , "Y") ; 

} 

Z.log.writeToLog(Z. log. DEBUGS, " THE prDATAALIASES ARE 

" + prDataAlias); 
// Merge the results 

//____* 


pri = prNameValues . keyset () . iterator () ; 
while (pri . hasNext ()) { 
isList = false; 

tempAlias = (String) pri. next (); 

Z.log.writeTol_og(Z.log.DEBUG5, " RELEASE RESULTS — 
Processing tempAlias = " +tempAl l as) ; 

// check to see if its a list 

i f ("Y" . equal slgnoreCase((Stri ng) 

prDataAl i as . get (tempAl i as) ) 

&& ! tempAl i as . equal slgnoreCase (PROBLEM_KEY_^ALIAS) ) 
nameVal ues . put (tempAl i as , (Ar rayLi st) 

prNameVal ues . get (tempAl i as) ) ; 

else 

nameval ues . put (tempAl i as , (St ri ng) 

prNameVal ues .get (tempAlias)) ; 

} // end while pri hasNext() namevalues 
} // end if there are results for that ID 

// If there are no release results for this sorted ID, we still need to 
// send back an empty. 

else { 

Z.log.writeToLog(Z.log.DEBUG5," RELEASE RESULTS — no 
release results for this sorted ID " +sortedld ); 

Z.log.writeToLog(Z.log.DEBUG5," RELEASE RESULTS -- no 
release results releaseFieldList is : "+ releaseFieldList) ; 

for (int i = 0; i < releaseFieldList. si ze() ; i++) { 
key = (string) (releaseFieldList. get(i)) ; 
thisDDE = (DDEntry) (dictionaryFields.get(key)) ; 
ddeType = thisDDE.getType() ; 
ddeName = thisDDE.getName() ; 
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tempList = new ArrayList(); 
tempLi st . add (emptyst ri ngSpaee r) ; 
if (nameValues.get(ddeName) == null) { 
if (thisDDE.isMultipleValueO && 
! ddeName . equal slgnoreCase (PROBLEM_KEY_JVLIAS) ) 

nameval ues . put (ddeName , tempLi s t) ; 
else if 

(ddeName .equal slgnoreCase (PROBLEM_KEY_J\LIAS)) 

nameval ues . put (ddeName , sortedld) ; 

else 

nameval ues . put (ddeName , emptyst ri ngSpacer) ; 

} } 

} 

//Z.probe(" NAME VALUES : " + nameval ues); 

} 

/* Process the Attachment Results 

*/ 

if (doPAQuery) { 

if ((tmpobj = paResul ts.get(sortedld)) != null) { // if there 
are results for this ID 

paNameValues = (HashMap) tmpobi ; 
Z.log.writeTol_og(Z.log.DEBUG5, ' paNameValues = " 

+paNameValues ) ; 

// Merge the results 

// 

pai = paNameValues. keyset() .iterator() ; 
while (pai . hasNext()) { 

isList = false; 

tempAlias = (string) pai. next (); 
i f ("Y" . equal slgnoreCase ( (Stri ng) 

paDataAl i as . get (tempAl i as) ) 

&& ! tempAl i as . equal slgnoreCase (PROBLEM_KEY_ALIAS) ) { 
Z . log . wri teToLog(Z. log . DEBUGS , " tempAlias = " 

+tempAlias ); 

Z . 1 og . wri teToLog (Z . 1 og . DEBUG5 , " 
/ (ArrayList) paNameValues. get (tempAlias) = " +(ArrayList) 
paNameVal ues . get (tempAl i as) ) ; 

nameval ues . put (tempAl i as , (Ar rayLi st) 

paNameVal ues . get (tempAl i as) ) ; 

} 

else 

nameval ues . put (tempAl i as , (St ri ng) 

paNameVal ues . get (tempAl i as) ) ; 

} 

} // end if there are results 

/* If there are no results for this sorted ID, we still need to 
send back an empty. 

*/ 

else { 

for (int i = 0; i < attachmentFieldl_ist.size() ; i++) { 
key = (String) attachmentFieldList.get(i) ; 

Z.probe("LOOKING AT ATTACHMENTS about to look for 

ddentry with key = " + key); 

thisDDE = (DDEntry) (dictionaryFields.get(key)) ; 
// ddeType = thi sDDE . getType() ; 

ddeName = thisDDE.getName() ; 
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if (nameval ues. get (ddeName) == null) { 
if (thisDDE.isMultipleValueO && 
! ddeName . equal slgnorecase (PR0BLEM_KEY_^ALIAS)) 

nameValues.put(ddeName, new ArrayListO) ; 
else if 

(ddeName. equal slgnoreCase(PROBLEM_KEY_ALlAS)) 

nameval ues . put (ddeName , sortedld) ; 

else 

nameval ues . put (ddeName , emptySt ri ngspacer) ; 

} } 

} 

} // end if doPAQuery 

fi nal Resul ts . put (sortedld , nameval ues) ; 

//z.log.writeToLog(z. log. DEBUG, "RPT: vAl i dAtion list final RESULTS:" + 
final Results) ; 

} catch (Exception e) { 

Z. log. writeToLog(Log. ERROR, this, "Error in method getselect:" + e) ; 

Errorwriter.wri te(e, ErrorWri ter . LOG) ; 

throw e; 
} finally { 

if (pstmt != null) pStmt.close() ; 

if (pmstmt != null) pmStmt.close() ; 

if (prstmt != null) prStmt.close() ; 

if (pastmt != null) paStmt.close() ; 

z. log . wri teToLog(Log . DEBUG3 , this , 
"AAAAReport. getselect. doUDFMul ti/TextQuery = true udfMULTl/TEXTStatement closed"); 

if (udfstmt != null) udfStmt.close() ; 

mul ti Lookups . cl ear () ; 

// 

// PRINT OUT TO THE LOGS FOR TESTING PURPOSES 

// 

Iterator itx = fi nal Resul ts . keyset() . iterator() ; 
Iterator itv = null ; 
HashMap h = null 
String id « 
String name = 
string value = 
Z . 1 og . wri teToLog (Log . DEBUG4 , "THE FINAL RESULTS ARE: "); 

Z . 1 og . wri teToLog (Log . DEBUG4 , " ") ; 

while (itx.hasNext()){ 

id = (String)itx.next() ; 

z. log. wri teToLog (Log. DEBUG4, "processing for id: "+ id); 
h = (HashMap) final Results. get (i d) ; 
itv = h.keyset() .iteratorQ ; 
while (itv.hasNext()){ 

name = (string)i tv. next() ; 

Z.log.writeToLog(Log.DEBUG4, " " + name +" / 

+ h. get (name)) ; 

} 

} 

return fi nal Resul ts; 

} 

} 


ii ii 

i 

i 

n n 


* getReportList() 

* ©pararn dbconn 
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* ©return HashMap of ids as key and titles 

* Gets the list of reports for that user 

/ 

public static HashMap getReportList(String userld, Connection dbconn) throws 
Exception { 

Z . 1 og . wri teToLog (Log . DEBUGl , "Enteri ng Report . getReportLi st Method") ; 

HashMap idRpts = new HashMapO; 

String query = null ; 

String id = null ; 

String title = null; 

PreparedStatement statement = null; 

Resultset rset = null; 

Report rpt = nul 1 ; 

try { 


query = "SELECT report_id, title, report_type_name, description, 
ti tle_map_key " + 

"from REPORT where security_JJser_id = ? " + 

"and UPPER(report_type_name) not in ('QUICKLIST* , 'DETAILED') " + 

"order by title "; 
statement = dbconn. preparestatement (query) ; 
statement. setstring(l, userld) ; 

String bv = PreparedStatement Proxy. getBindValues (statement) ; 
Z.log.writeToLog(Log.DEBUG2, "Report .getReportList QUERY = " + query); 
Z.log.writeToLog(Log.DEBUG2, "Report .getReportList Bindvalues = " + bv) ; 
rset = statement. executeQueryO ; 

while (rset . next()) { 
rpt = new Report () ; 

rpt . setName (rset . getst ri ng ("TITLE")) ; 

rpt .setReportType(rset. getstri ng("REPORT_TYPE_NAME")) ; 

rpt . setTi tl e (rset . getstri ng ("DESCRIPTION") ) ; 

rpt. titleMapKey = rset . getLong ("TITLE_MAP_KEY") ; 

idRpts. put(rset. getstri ng("REPORT_ID") , rpt) ; 

return idRpts; 
} catch (Exception e) { 

Z. log. writeToLog(Log. ERROR, "Error in method getReportList:" + e) ; 
//ErrorWri ter. write (e, ErrorWri ter . LOG) ; 

throw e; 
} finally { 

if (statement != null) statement. closeQ ; 


} 


} 


* bui 1 dQueryStri ng () 

* Oparam select stri 

* @param from stri 

* @param where Stri 

* @param andProblem Stri 

* @param andother stri 
@param andUDF stri 


ng 
ng 
ng 
ng 
ng 
ng 


@param andKeyword string 
* ©return string the query string 


Gets a new report id from sequence 

/ 

private string bui 1 dQueryStri ng (String select, 
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stri ng 
stri ng 
Stri ng 
Stri ng 
String 
stri ng 
stri ng 


.java 
from, 
where, 

andPreCondition, 
andltemType, 
andProblem, 
andother , 
andUDF, 
andKeyword, 
andsortorder , 
orderBy , 

groupBy) throws Exception { 


boolean whereExists = false; 
boolean groupByExists = false; 
StringBuffer query = new stri ngBuffer() ; 
int defaultLength = 5; //" and ".lengthQ; 


try { 


query. append(select + from + where); 

* ADJUST THE 1st " AND " in the where criteria 

* So if there is nothing in the where clause, the first statement in 
the where clause 

* needs to have its first "and" string removed otherwise the sql 
would read : "where and exists (select )" 

V 

if (andPreCondition. length() > defaultLength) { 
whereExists = true; 

query. append("(" + andPreCondition + ")"); 


if (whereExists) 

query. append(andltemType) ; 
else if (andltemType. length () > defaultLength) { 

whereExists = true; 

query . append(and!temType . substri ng(4)) ; 


if (whereExists) 

query . append (andProblem) ; 
else if (andProblem. length() > defaultLength) { 

whereExists = true; 

query . append (andProblem. substri ng(4)) ; 


if (whereExists) 

query . append (andother) ; 
else if (andother . length() > defaultLength) { 

query . append (andother . substri ng (4)) ; 

whereExists = true; 


if (whereExists) 

query. append(andUDF) ; 
else if (andUDF.lengthO > defaultLength) { 

query . append(andUDF. substri ng(4)) ; 

whereExists = true; 
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if (whereExists) 

query . append(andKeyword) ; 
else if (andKeyword. length() > defaul tLength) { 

que ry . append (andKeywo rd . subs t ri ng (4) ) ; 

whereExists = true; 

} 

if (whereExists) 

query . append(andsortorder) ; 
else if (andsortorder . length() > defaul tLength) { 

query . append (andsortorder . subs tri ng(4)) ; 

whereExists = true; 

} 

if (groupBy. length() > " group by M .length()) { 
query. append(groupBy) ; 
groupByExists = true; 

} 

catch (Exception e) { 

Z. log. writeToLog(Log. ERROR, "Error in method buildQueryString: " + e) ; 
throw e; 

} 

if (whereExists) 

return query . tostri ng() + orderBy; 
else { 

if (groupByExists) return select + from + groupBy + orderBy; 
else return select + from + orderBy; 


* getNewReportld() 

* @param dbconn 
©return new reportid 


* 


Gets a new report id from sequence 

public static String getNewReportld() throws Exception { 
try { 

return Sequence. getNewSequenceld("REPORT_SEQ M ) ; 
} catch (Exception e) { 
throw e; 

} 

} 

* setconnection 

* @param dbconn 

public void setConnection(Connection conn) { 
this. conn = conn; 

* setchartld 

* @param chartld 

public void setchartld(i nt chartld) { 
this. chartld = chartld; 
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/■it* 

* setchart 

* Oparam reportchart 

public void setReportchart(ReportChart reportchart) { 
this. reportchart = reportchart; 

* setPresentationChart 

* Oparam presentationchart 

public void setReportChart(Chart chart) throws Exception { 
this. reportchart. setchart (chart) ; 

* getAlias() 

* Oparam table 

* ©return alias 

V 

private string getAlias(Stri ng table) { 
String alias; 

if (table. equal slgnorecase("PROBLEM") || table. equalslgnoreCase("lTEM")) 
alias = "p"; 

else if (table. startsWith( H PROBLEM_MODULE") || 
table. startsWith("lTEM_MODULE")) alias = "im"; 

else if (table. startsWi th("PROBLEM_RELEASE") || 
table. startswith("lTEM_RELEASE M )) alias = "ir"; 

else if (tab! e.startswith ("ATTACHMENT")) alias = V; 

else if (table. startswi th("RELATlONSHlP_GROUP_")) alias = "rg"; 

else alias = table; 

return alias; 

* delete 

* Oparam conn 

* Oparam userld 

public void del ete(Connection conn, String userld) throws Exception { 
this. conn = conn; 
if (this.newData == false) { 

this. del etedData = true; 

this.executeTransacti on (userld) ; 

} 

} 


private String bui IdLookupSql (stri 

Stri 
stri 
stri 


ng ddeName, 

ng ddeTable, 

ng ddeField, 

ng ddeDri verKey , 


String ddeChildKey, 


ng ddeParentTable, 

ng ddeParentKey , 

ng ddeGrandParentTable, 

ng ddeGrandParentKey , 

ng ddeGrandchi 1 dKey , 


Stn 
Stri 
Stri 
Stri 
Stri 

String ddeLookupTabl e , 
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String ddeLookupColumnl, 
String ddel_ookupColumn2 , 
string ddeLookupCol umn3 , 
String ddeLookupKey, 
string ddeDisplayType, 

string ddeMul ti p 1 eVal ue) throws Exception { 


String lookupSql = 
Stri ng temp = ' " ; 
String tempwhere = ""; 

try { 

dataAlias.clearO ; 

// USED IN SELECT CLAUSE 

/* */ 

if (ddeTable == null) ddeTable = ) 

if (ddeParentTable == null) ddeParentTable 


ii n . 


// is a field 

i f (TextManager . i sSt ri nglnvi si bl e(ddeLookupKey) 

&& TextManager .isstri nglnvi si ble(ddeLookupColumnl)) { 

lookupSql = getAli as (ddeTable) + "." + ddeField + " " + q + ddeName 

+ q; 

dat aAl i as . put (ddeName , ddeMul ti pi eVal ue) ; 
else { 


/* ****SPECIAL CASE HARD CODED!!!!!! 

V 


TO DO: use product_release_id 


if ( M PRODUCT_RELEASE". equal slgnoreCase(ddeLookupTable)) { 

temp = "PRODUCT_RELEASE. PRODUCT_NAME " + Z . dbms . o j equal s () + 

" PROBLEM_RELEASE . PRODUCT_NAME " + 

" and PRODUCT_RELEASE. RELEASE " + Z . dbms . oj equal S () + 
"PROBLEM__RELEASE . RELEASE_FOUND " ; 

el se i f (ddeLookupKey . toupperCase() . i ndexOf ("PR0JECT_ID")>-1) { 
temp = "PROJECT. PRO J ECT_ID" + Z . dbms . oj equal s () + 
getAli as (ddeTable) + + ddeField + 

" and PRO J ECT . AREA_ID" + Z . dbms . oj equal s () + 
getAl i as (ddeTabl e) +" . AREA_ID" ; 

else{ 

temp = ddeLookupTable+ "." + ddeLookupKey + Z. dbms. oj equal s() + 
getAli as (ddeTable) + ". fi + ddeField; 

} 


// is a calculation 

if (TextManager . i sStri nglnvi si ble(ddeLookupKey)) { 

lookupSql = ddeLookupColumnl + 11 " + q + ddeName + q; 
dataAl i as . put (ddeName , ddeMul ti pi eVal ue) ; 

} 

// turns out that this is a normal field that is also used as a lookup for allowed 
val ues 

// here the table is null, but the key and the column are not 

else if (TextManaqer. isstri nglnvi si ble(ddeLookupTable) 

I | ddeTable. equal signoreCase(ddeLookupTable)) { 
lookupSql = getAli as (ddeTable) + "." + ddeLookupColumnl - 
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dataAl i as . put (ddeName , ddeMul ti pi eVal ue) ; 
if (TextManager. isStringVi si ble (ddeLookupCol umn2)) { 
lookupsql += " + getAlias(ddeTable) + ■ + 


} 


" " + q + ddeName + this.sufxl + q; 
dataAl i as. put (ddeName + this.sufxl, ddeMul ti pi eVal ue) ; 


i f (TextManage r . i sst ri ngvi si bl e (ddeLookupCol umn3) ) { 


ddeLookupCol umn2 + 


lookupsql += " , " + getAli as (ddeTabl e) + 


it tt 


it it 


} 


+ q + ddeName + this.sufx2 + q; 
dataAl i as. put (ddeName + this.sufx2, ddeMul ti pi evalue) ; 


it 


if ("USER".egualslgnoreCase(ddeDisplayType)) { 

... Yj 

+ ddeName + this.sufx3; 


} 


lookupsql += '\ " + getAli as (ddeTabl e) + "." + ddeField + " 
dataAl i as. put (ddeName + this.sufx3, ddeMul ti pi eVal ue) ; 


} 


// lookup when problem, problem_release, or problerruriodule is the base table 

else if ("ITEM". equal slgnoreCase(ddeTable) 

ddeTabl e. startswi th("PROBLEM_MODULE") 
ddeTabl e . startswi th("PROBLEM_RELEASE") 
ddeTabl e . startswi th(" RELATIONSHIP") 
ddeTabl e . startswi th ("ITEM_MODULE") 
ddeTabl e . startswi th ("ITEM_RELEASE") 
"ATTACHMENT" . equal slgnoreCase (ddeTabl e) ) { 


ddeLookupCol umnl + 


ddeLookupCol umn2 + 

+*/ 


n ii 


lookupsql = "(select distinct " + ddeLookupTable + "." + 

" from " + ddeLookupTable + /*", " + ddeTabl e +*/ 
" where " + temp + ) " + q + ddeName + q + " " ; 
dataAl i as . put (ddeName , ddeMul ti pi eVal ue) ; 

i f (TextManager . i sst ri ngvi si bl e (ddeLookupCol umn2) ) { 

lookupsql += ", (select distinct " + ddeLookupTable + "." + 

" from " + ddeLookupTable + /*", " + ddeTabl e 

" where " + temp + ") " + ddeName + this.sufxl 

dataAl i as. put (ddeName + this.sufxl, ddeMul ti pi eVal ue) ; 

if (TextManager . isstri ngvisible(ddeLookupCol umn3)) { 

lookupsql += ", (select distinct " + ddeLookupTable + "." + 

" from " + ddeLookupTable + /*", " + ddeTabl e 

" where " + temp + ") " + ddeName + this.sufx2 

dataAl i as. put (ddeName + this.sufx2, ddeMul ti pi eVal ue) ; 

if ("USER" .equal slgnoreCase(ddeDisplayType)) { 

lookupsql += ", " + getAli as (ddeTabl e) + "." + ddeField + " 
" + ddeName + this.sufx3; 

dataAl i as. put (ddeName + this.sufx3, ddeMul ti pi eval ue) ; 

} // lookup when i tem_release, problem_module, problem is the parent 

table 

else if ("lTEM".equalslgnoreCase(ddeParentTable) 
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ddeParentTable. startswi th("PROBLEM_MODULE") 
ddeParentTabl e . startswi th (" PROBLEM_RELEASE") 
ddeParentTabl e . startswi th ("ITEM_RELEASE") 
ddeParentTabl e . startswi th ("ITEM_MODULE") 
"ATTACHMENT". equal signorecase (ddeParentTabl e) 


it ii 


RELATIONSHlP_GROUP_PROBLEM" .equal slgnoreCase(ddeParentTable) 

II 

"relationship_group__view" .equal slgnoreCase(ddeParentTable)) { 

if ("". equal s(ddeGrandParentTable)) { 

tempwhere = " where " /*+ ddeParentTabl e + "." + 

ddeDriverKey + "=" + 

getAlias(ddeParentTable) + "." + ddeDriverKey + 

" and " */+ ddeTable + "." + ddeChildKey + Z.dbms.oj equal s() 

+ 

getAlias(ddeParentTable) + "." + ddeParentKey + 
* and " + temp + ") "; 

} else { 

tempwhere = " where " + ddeParentTabl e + "." + 
ddeGrandChildKey + Z.dbms.ojequalsQ + 

getAlias(ddeGrandParentTable) + " ." + 

ddeDriverKey + 

" and " + ddeTable + "." + ddeChildKey + 

Z.dbms.ojequalsQ + 

ddeParentTabl e + "." + ddeParentKey + 
" and " + temp + ") "; 

} 

lookupsql = "(select distinct " + ddeLookupTabl e + "." + 

ddeLookupColumnl + 

" from " + ddeLookupTabl e + /*", " + ddeTable + ", " 

+ ddeParentTable +*/ 

tempwhere + q + ddeName + q + 
dataAl i as . put (ddeName , ddeMul ti pi eval ue) ; 

i f (TextManager . i sSt ri nqVi si bl e (ddeLookupCol umn2) ) { 

lookupsql += ", (select distinct " + ddeLookupTabl e + "." + 

ddeLookupCol umn2 + 

" from " + ddeLookupTabl e +/* " + ddeTable + 

", " + ddeParentTable +*/ 

tempwhere + ddeName + this.sufxl + " "; 
//Z.probe("RPT:MULTl2 alias2:" + ddeName + this.sufxl); 

dataAl i as. put (ddeName + this.sufxl, ddeMul ti pi eval ue) ; 

i f (TextManager . i sSt ri ngvi si bl e (ddeLookupCol umn3)) { 

lookupsql += ", (select distinct " + ddeLookupTabl e + "." + 

ddeLookupCol umn3 + 

" from " + ddeLookupTabl e +/* " • " + ddeTable + 

+ ddeParentTable +*/ 

tempwhere + ddeName + this.sufx2 + " "; 

//Z.probe("RPT:MULTl2 alias2:" + ddeName + this.sufx2); 

dataAl i as. put (ddeName + this.sufx2, ddeMul ti pi eval ue) ; 

if ( ,, USER".equalsIgnoreCase(ddeDisplayType)) { 
if ("".equals(ddeGrandParentTable)) 

lookupsql += ", " + getAli as (ddeParentTable) + "." + 
ddeField + " " + ddeName + this.sufx3; 

else 

lookupsql += ", " + ddeTable + "." + ddeField + " " + 

ddeName + this.sufx3; 
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dataAlias.put(ddeName + this.sufx3, ddeMultipleValue) ; 


/* lookupsql = "(select " + ddeLookupTable + "." + 

ddeLookupColumnl + 

" from " + ddeLookupTable + M , " + ddeTable + ", " + ddeParentTable + " , " + 
driverTable + 

" where " + driverTable +"."+ driverField + "= p. id "+ 

" and " + ddeTable +"."+ ddeChildKey + Z.dbms.ojequals() + ddeParentTable +"." 
ddeParentKey + 

" and " + ddeParentTable + "." + ddeParentKey + 
Z.dbms.oj equal s() + driverTable + "." + driverField + 
" and "+ ddeLookupTable+ " ." + ddeLookupKey + 
Z.dbms.ojequalsO + ddeTable*". " + ddeField + ")"; 

V 

//Z.probe("RPT:doing LOOKUP — 2 tables out ARGHH") ; 

dataAl i as . put (ddeName p ddeMul ti pi eval ue) ; 

} } 

} catch (Exception e) { 

Z. log. writeToLog(Log. ERROR, this, "Error in method buildLookupSql 

e); 

//E rrorWriter.wri te(e, Errorwri ter . LOG) ; 

throw e; 

} 

return lookupsql ; 

* processResul ts 

* @param ResultSet rs 

* @param ArrayList aliases 

* ©return HasnMap 

* Processes the result set and groups information into lists if multipl 
records are found 

private HashMap processResul ts(ResultSet rs, 

HashMap aliases, 

HashMap ddeDisplayedDates , 

HashMap ddeTextFields, 

HashMap ddeDisplayURLs , 

HashMap dictionary Fields, 

SesameSession session) throws Exception { 


Stn 
Stri 
Stri 
Stri 
Stri 


boolean isList = false; 

"ng key = ""; // general key for hashmap lookups 
ng pKey = ""; // the problem id as a key 
ng listKey = ""; // tamporary key value 
ng multiple = ""; 
ng baseKey = "" ; 
String temp = ""; 
ArrayList dataList = null; 
HashMap rows = null; 
HashMap fieldResults = null; 
HashMap recordResul ts = new HashMapO; 
HashMap results = new HashMapO; 
HashMap multi Lookups = new HashMapO; 
Set ali asset = aliases. keyset () ; 
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DDEntry ddeTemp = null; 
DbTime dbt = nul 1 ; 
SecurityUser su = null; 
String multi = ""; 
String multil = "" 
String multi 2 = "" 
String multi 3 = "" 

ReportElement re = new ReportElement(null , null, ischart, hr); 
try { 

dbt = new DbTime(session, conn); 

su = (SecurityUser) session. getAttribute("usER") ; 

while (rs.nextO) { 

rows = new HashMapO; 

pKey = rs.getString(PROBLEM_KEY_ALlAS) ; // this is the problem id 

multi Lookups = new HashMapO; 

// create a HashMap of Arraylists for each problem ID to store field info 

if ((fieldResul ts = (HashMap) recordResults.get(pKey)) == null) 
fieldResults = new HashMapO; 

// Create the List if this is the first repeating value (id) 

// * » 

Iterator aliaslterator = aliasSet.iterator() ; 

while (aliaslterator . hasNextO) { 
isList = false; 

key = (string) aliaslterator . next() ; 
multiple = (string) aliases. get (key) ; 

if (key.endswi th(sufxl) | | key . endswi th(sufx2) | | 

key . endswi th(sufx3)) 

baseKey = key.substring(0, key.length() - sufxl. 1 engthO) ; 

else 

baseKey = key; 

ddeTemp = (DDEntry) dictionaryFields.get(baseKey) ; 

if ("USER". equal slgnoreCase(ddeTemp == null ? "" : 
ddeTemp. getDisplayType())) { 

// Check for a multi lookup — > currenly ONLY when display_type = user 
// --> TODO: display_as_url = y 

// 

//2.probe("RPT: BASEKEY : " + baseKey); 

//z. probe("RPT: ddeTemp »>" +baseKey) ; 


unprocessed fields 


if (multi Lookups. get(baseKey) == null) { // only process 


// LOOKUPl 


multil = "" 
multi2 = "" 
multi3 = "" 


multi = rs.getString(baseKey) ; 

mul ti Lookups . put (baseKey , baseKey) ; 


Page 140 


Report. java 

// L00KUP2 


// L00KUP3 


// L00KUP4 


multil = rs.getString(baseKey+sufxl) ; 
mul ti Lookups . put (baseKey+suf xl , baseKey) ; 


multi2 = rs.getString(baseKey+sufx2) ; 
mul ti Lookups . put (baseKey+suf x2 , baseKey) ; 


multi3 = rs.getString(baseKey+sufx3) ; 
mul ti Lookups . put (baseKey+suf x3 , baseKey) ; 


if ("Y". equal slgnoreCase(mul ti pie) && 
! key . equal slgnoreCase(PROBLEM_KEY_ALIAS) ) { 

if ((dataList = (ArrayList) fieldResults.get(key)) 

== null) { 

dataList = new ArrayList(); 
isList = true; 

Z . 1 og . wri teToLog (Z . 1 og . DEBUG5 , "MULTIPLE »> 
this.getEmailLink = " +this.getEmailLink(multi3,multi ,multil,multi2)) ; 

dataLi st . add (thi s . getEmai 1 Li nk(mul ti 3 , 

mul ti , 

multil, 

multi2)); 

} 

else{ 

Z. log. wri teToLog(z. log. DEBUGS, "SINGLE »> 
this.getEmailLink = " +this .getEmai 1 Li nk(mul ti 3 , mul ti , mul ti 1, mul ti 2)) ; 

f i el dResul ts . put (baseKey , thi s . getEmai 1 Li nk (mul ti 3 , 
mul ti , 
mul ti 1, 
multi2)); 

} 

// ^ if (isList) fieldResults.put(baseKey, dataList); 

} 

else { 

//if ("USER". equal slgnoreCase(ddeTemp == null ? "" : ddeTemp.getDisplayType())) 
// mul ti Lookups. put (key, baseKey); 

// Get the result — format based on display type 

// :„i„i: 

if (ddeDisplayedDates.get(key) != null) 
temp = formatDateString(dbt, 
su , 

Convert . toCalendar(rs . getTimes tamp (key)) , 
emptyStri ngSpacer) ; 
else if (ddeDisplayURLs.get(key) != null) 

temp = getURLLi nk((stri ng) ddeDisplayURLs.get(key) , 
rs.getst ring (key)) ; 
else if (ddeTextFi elds. get (key) != null) 
temp = this.isTextOutputType() 

? rs.getstring(key) 

■ 

TextManager . converturl (getPri ntabl eResul t (rs . getstri ng (key) )) ; 
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else 

temp = getPrintableResult(rs.getString(key)) ; 
// If there is a multiple value (don't want a list of the 

probl emKeys) 

// get the dataList, add the value, put the datalist back in 

// _ 

if ("Y M . equal slgnoreCase(mul ti pie) && 
! key.equalslgnoreCase(PROBLEM_KEY_ALlAS)) { 

isList = true; 

if ((dataList = (ArrayList) fieldResults.get(key)) == 

null) { 

dataList = new ArrayListO; 

} 

dataList. add(temp) ; 

} 

// This is a single value 

// 

else { 

f i el dResul ts. put (key, temp); 
recordResul ts . put (pKey , f i el dResul ts) ; 

} //end if else user_type 

if (isList) fi el dResul ts. put (key, dataList) ; 
} // finished processing fields 

// Process the multi-row stuff here 

// 

if (isList) recordResults.put(pKey, fieldResults) ; 
} // end while rs.next() 

} 

catch (Exception e) { 

Z.log.writeToLog (Log. ERROR, this, "Error in method process Results:" + 

e); 

//Errorwri ter .write (e, ErrorWri ter . LOG) ; 

throw e; 

////z. probe("RPT: HERE ARE THE RESUSLTS : " + recordResul ts) ; 
return recordResul ts; 

} 

* getPrintableResul t() 

* @param String s 

* ©return String s 

* utility function that either returns an empty string spacer or the value 

*/ 

private String getPrintableResul t(string temp) { 
Stri ng s = nul 1 ; 

i f (TextManage r . i sst ri nglnvi si bl e (temp) ) 

s = emptystringspacer ; 
else { 

if (isTextOutputTypeO) 
s = temp; 

else 
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s = TextManager. replaceLineFeed(TextManager.htmlescape(temp)) ; 
return s; 

} 

* getFormattedNameForQueryO 

* @param String fName 

* ©param String iName 

* ©return string 

* Create the formatted name based on the Application Default value 

private String getFormattedNameForQuery (string tableAlias, 

String securi tyuserld, 

String firstName, 

String lastName) throws Exception { 

string display = Z . appDef aul ts . getAttri bute("USERNAME_DlSPLAY") ; 
String text = ""; 


try { 


it i i H 


H i i ?! 


if ("FIRST". equalslgnoreCase(display)) { 

text = (TextManager. isstringvi si bl e (f i rstName) 

? ("(" + tableAlias + "." + firstName + " " + Z.dbms.catO + 

z.dbms.catQ + " " + tableAlias + "." + lastName + ")") 
: tableAlias + "." + lastName); 

else if ("LAST" . equal slgnoreCase(di splay)) { 

text = (TextManager . isstringvi si ble(fi rstName) 

? ("(" + tableAlias + "." + lastName + " " + Z.dbms.catO + 


Z.dbms.catO + " " + tableAlias + "." + firstName + ,, ) ,, ) 
: tableAlias + "." + lastName); 

else{ 

text = tableAlias + "." + securi tyuserld; 

} 

} catch (Exception e) { 

Z. log. writeTol_og(Log. ERROR, this, "Error in method 
getFormattedNameForQuery:" + e) ; 

//ErrorWri ter .wri te(e, ErrorWri ter . LOG) ; 
throw e; 

return text; 

} 

* getURLLinkQ 

* Sparam String urlName 

* @param String displayName 

* ©return String 


Create the email link based on the Application Default value 

7 

private String getURLLi nk(Stri ng url p string value) throws Exception { 

StringBuffer html = new Stri ngBuf f er () ; 
Regex r = null ; 

Page 143 


Report. java 

try { 

i f (TextManager . i sst ri nglnvi si bl e (val ue) ) return 
getPri ntabl eResul t (val ue; ; 

value = getPri ntabl eResul t (value) ; 

r = new Regex("(?e=~)~$~$~w+~$~$" , value); 

if (this.isHTMLOutputTypeO) 

html .append("<a href=\"" + r . replaceAl 1 (url) + "\"><u>"); 

html . append(val ue) ; 

if (this.isHTMLOutputTypeO) 
^ html . append("</ux/a>\n") ; 

catch (Exception e) { 

Z. log. writeToLog(Log. ERROR, this, "Error in method getURLLi nk: " + e) ; 
throw e; 

} 

return html . toStri ng() ; 


* getEmailLink() 

* @param string ddName 

* @param string userld 

* @param String fName 

* @param string iName 

* ©par am String email 

* ©return String 

* Create the email link based on the Application Default value 

private string getEmai 1 Li nk(stri ng userld, 

string firstName, 
string lastName, 

string email) throws Exception { 
stringBuffer html = new stri ngBuffer() ; 
try { 

html . append(Securi tyliser . getUserNameDi spl ay (userld , f i rstName , 1 astName , 
email , this.isHTMLOutputTypeO)) ; 

if (html . length()==0) return emptyStringSpacer; 
else if (TextManager. isstringlnvisible(ntml . toStri ng())) return 
emptyStringSpacer; 

else return html . toStri ng() ; 

catch (Exception e) { 

Z. log. writeToLog(Log. ERROR, this, "Error in method getEmai 1 Li nk : " + e) ; 
throw e; 


private ArrayList bui ldReleaselnList(ArrayList sortedKeys, 
string rQuery, 

HashMap suppressedReleaseFilters) throws Exception{ 
//Z.probe("lN buildReleaselnList "); 
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StringBuffer query = new stri ngBuffer(rQuery) ; 
ArrayList sortKeys = new ArrayList(sortedKeys) ; 

try{ 

String cri teriaTableColumn = ""; 
int criteriasize =0; 
Fi 1 ter mf = nul 1 ; 
ArrayList mfc = null; 
ArrayList rawfc = null; 
DDEntry dde = null; 
boolean skipcomma = false; 
boolean hasNullCri teria = false; 
boolean wildcards = false; 
String rawvalue = ; 
string processedvalue = ""; 

// 

// THIS IS A HACK 

// the right way to do this is to redo the release query using the 
QueryBuilder getMasterList , 

// but change the driver table and driver talbe keys 

// — wont work with dates 

// -- doesn't care about dde's with parent table = "problem_release" 

// 

Z.probe("buildReleaselnList: SuppressedMultiReleaseFlLTERS = " + 
suppressedReleaseFilters ); 

Iterator it = suppressedRel easeFi 1 ters . keySetO . i terator() ; 

whi 1 e(i t . hasNext ()) { 

skipcomma = false; 

mf = (Filter)suppressedReleaseFilters.get(it.nextO) ; 
rawfc = (ArrayList)mf .getFilterCriteriaResolved() ; 
mfc = new ArrayListO; 

dde = mf .getDDEntryO ; 

hasNullCri teria = false; 
criteriasize = rawf c . si ze() ; 


// 

// this is a hack 

// 

wildcards = false; 

for (int m = 0; m < criteriasize; m++){ 
rawvalue = (Stri ng) rawfc. get (m) ; 

if ("{nul 1} M . equal slgnorecase(rawvalue)) hasNullCriteria = true; 

processedvalue = 
TextManager. replace (rawvalue, "*",z.dbms.wiLDCARDO) ; 

if ("{nul 1 }" . equalslgnoreCase(processedVal ue)) hasNullCriteria = 

true; 

i f ("USER" . equal slgno recase (dde . getDi spl ayType () ) ) 

mfc . add(processedval ue . tollpperCase (Z . def aul tLocal e)) ; 

else 

mfc . add (processedval ue) ; 
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if (rawvalue.indexof ("*") > -1) wildcards = true; 

} 

criteriasize = mfc.sizeQ; 


if (wildcards){ 

Z.probe("buildReleaselnList: 30 ") ; 

//filter criteria loop 

for (int k = 0; k < criteriasize; k++){ 

if (k == 0) query. append(" and ( "); 

else query . append(" or "); 

query. appendC'UPPER("+ dde.getTableName() + "." + 
dde.getcolumnNameO + ") "); 

query. append(" LIKE UPPER(?) ") ; 
} sortKe y s.addCCstrin g > f c. ge t(k»; 

query. append(") "); 


} 

else{ 

Z. probe ("bui IdReleaselnLi st : 40 ") ; 

if (hasisiullcri teria) query. append(" and ( "); 
else query . append(" and ") ; 

criteriaTableColumn = dde.getTableNameO + "." + 

dde . getcol umnName() ; 

query. append(cri teri aTabl eCol umn + " in ( ") ; 

if (hasNull Criteria && criteriasize == 1){ 
query. append(" is null "); 


for (int k = 0; k < criteriasize; k++){ 
if (hasNullCriteria){ 

i f ("{nul 1 }". equal slgnoreCase((St ri ng)mf c . get (k))) { 
hasNullCri teria = true; 
skipComma = true; 
conti nue; 

} 

} 

if (k > 0 && IskipComma) query . append(" , "); 
skipComma = false; 
query. append("?") ; 

} sortKe yS .add((stnn 9 , m fc.,et(k» i 

query . append(") "); // end in 

if (hasNullCri teria) query . append(" or " + criteriaTableColumn + 
" is null ) n ); // end or is null 

// query. append("ORDER BY DATE_CREATED DESC"); 

}// end if not wildcards 
z.probe( M buildReleaselnl_ist: 50 "); 
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} 

catch (Exception e){ 
throw e; 

} 

final ly{ 

Z. probe("@; a)-> — < the query is : " + query); 
return thi s . bui 1 dlnLi s t (so rtKeys , que ry . tost ri ng () ) ; 

} } 

* buildlnListO 

* @param ArrayList sortedKeys 

* @param String query 

* Build the IN CLAUSE FOR THE RELEASE OR MODULE TABLES 

private ArrayList bui ldlnList(ArrayList sortedKeys, String query) throws 
Exception { 

ArrayList keys = new ArrayListO; 
Preparedstatement stmt = null; 
Resultset rs = null ; 

try { 

Z. probe("RPT: the in list Query is " + query); 

Z. probe("RPT: the in list params are " + sortedKeys); 

stmt = conn. preparestatement(query) ; 

// Bind the block of problem IDs 

// 

for (int k = 0; k < sortedKeys. si ze() ; k++) 

stmt.setstring(k + 1, (string) sortedKeys . get (k)) ; 

rs = stmt.executeQueryO ; 

// Get the result set 

// 

while (rs.nextQ) { 

keys.add(rs.getstring(l)) ; 


} catch (Exception e) { 

Z. log.wri teToLog (Log. ERROR, this, "Error in method builelnList:" + e + 
with query: " + query); 

//Errorwri ter .wri te(e, ErrorWri ter . LOG) ; 

throw e; 
} finally { 

if (stmt != null) stmt . close() ; 

return keys; 

} 

} 

* buildlnListO 

* @param String query 

* Build the IN CLAUSE FOR THE RELEASE OR MODULE TABLES 

private stringBuffer buildmclause(ArrayList keys) throws Exception { 
StringBuffer inCriteria = new Stri ngBuffer () ; 
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try { 

i nCri teri a . append (" (") ; 

for (int k = 0; k < keys.sizeC); k++) { 

if (k > 0) incriteria.append(", "); 

i nCriteria.append("?") ; 

i nCri te ri a . append (") ") ; 
} catch (Exception e) { 

Z.log.writeToLog (Log. ERROR, this, "Error in method buildlnclause 

throw e; 

return inCriteria; 


* formatDateStri ng() 

* @param session 

* @param dbconn 

* @param dateStr 

* ©return string 

private static String formatDateStri ng(DbTime dbt, 
SecurityUser su, 
Calendar calendarDate, 

String emptyStringSpacer) throws Exception { 
String timestampstring = emptyStringSpacer; 
if (calendarDate == null) return timestampstring; 
try { 

dbt . setDbNow(calendarDate) ; 

timestampstring = dbt .getFormattedDate(su.getDateFormatO) ; 
} catch (Exception e) { 

throw e; 
} finally { 

return timestampstring; 

} } 

* toLogO 

public void toLogO { 

if (this.fg != null) this.fg. toLogO ; 
if (this.l != null) this.l .toLogO; 
if (this. so != null) this. so. toLogO ; 


private string getHi storyEqui valent(String ddeTable) { 

if (("ITEM" .equal signoreCase (ddeTable) 

l, lTEM_MODULE" .equal slgnoreCase(ddeTable) 
"ITEM.UDF" . equal signoreCase (ddeTabl e) 
' , ITEM_TEXT" . equal slgnoreCase(ddeTabl e) 
^PROBLEM" . equal signoreCase (ddeTabl e) 
•pROBLEM^RELEASE". equal signoreCase (ddeTable) 
, PROBLEM_MODULE" . equal signoreCase (ddeTabl e) 
, PROBLEM_UDF M . equal slgnorecase(ddeTabl e) 
M PROBLEM_TEXT". equal signoreCase (ddeTable)) 

&& 
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TextManager . i sst ri ngvi si bl e (ddeTabl e) ) 

ddeTable += M _HIST M ; 

return ddeTable; 

} 

private String getHistKey(Stri ng tableName, boolean isUDF) { 
i f (tabl eName . startswi th( M lTEM_UDF_HlST") 
tabl eName . startswi th ("ITEM_MODULE") 
tableName. startswi thC M PROBLEM_MODULE M ) 
isUDF) 

return "LAST_DATE_UPDATED H ; 

else { 

return h timestamp m ; 

} } 

J-k-k 

* destroyO 

* cleans up instance objects - result set & prepared statement 

•k-k J 

public void destroyO throws Exception { 
try { 

dataAlias.clear() ; 
} catch (Exception e) { 

throw e; 
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* 
* 

* 
* 


SWorkfile: ProblemjJDF. java $ 

$Revision: 86 $ 

$Modtime: 12/30/02 12:54p $ 


Title: 

Description 

Copyright: 

Company: 

©author 

©version 


Problem_UDF 

UDF related Problem Functionality 

Copyright (c) 2001 

Sesame Techbnology 

Udele Malabanan 

1.0 



rt//c (CA 7/<sn/ 
10 f 7^^9 (( 


/ 


package com . ext ravi ew . appl ogi c . probl em ; 


mport java. text.*; 
mport ]ava.util . *; 
mporit java.sql . *; 
import java.io.*; 


i 
i 
i 


import 
import 
import 
import 
"mport 
mport 
mport 
mport 
mport 
mport 


com 
com 
com 
com 
com 
com 
com 
com 
com 
com 


ext ravi 
ext ravi 
ext ravi 
ext ravi 
ext ravi 
ext ravi 
ext ravi 
ext ravi 
ext ravi 
sesame. 


ew. 
ew. 
ew. 
ew. 
ew. 
ew. 
ew. 
ew. 
ew. 
log 


presentation. * ; 
util .*; 

uti 1 . cmp . busi ness . Mi sc ; 

common.*; 

appl ogi c. admin.*; 

appl ogi c. * ; 

appl ogi c . hi sto ry . * ; 

appl ogi c . securi ty . * ; 

dbms . dataMi g rati on . * ; 


mport com.stevesoft.pat.*; 


import com. sesame. mi sc.*; 


* <pxb>Description:</b>Class Problem_UDF is responsible for handling UDFs for a 
Prob I em. 

* It is a representation of column values stored in the problem_text, problem_udf 
and 

* UDF_LIST tables for a particular problem. </p> 

* Software written by:<br> 
*<br> 

*&nbsp;&nbsp&nbsp;&nbsp Sesame Technology<br> 
*&nbsp;&nbsp&nbsp;&nbsp 269 Mt Hermon Road, Suite 205<br> 
*&nbsp;&nbsp&nbsp;&nbsp Scotts Valley, CA 95066<br> 
*<br> 

*&nbsp;&nbsp&nbsp;&nbsp Web: www. sesame. com<br> 
*&nbsp;&nbsp&nbsp;&nbsp Phone: (831) 461-7100<br> 

* <b>Copyright (c) 1999-2001 by Sesame Technology</bxbr> 

* <br> 

V 


public class Problem_UDF implements Transactional, Cacheable, Cloneable, 
serializable { 
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// Sourcesfe Versioning Information 

public static final String vssworkfile = "Sworkfile: Problem_UDF. java $ 

public static final string vssRevision = M $Revision: 86 $ M ; 

public static final String vssModtime = "$Modtime: 12/30/02 12:54p $"; 


private 
private 
private 
private 
private 
private 
private 
private 
private 
private 
private 


stri ng 

String 

Stri ng 

String 

float 

Calendar 

String 

Calendar 

Calendar 

Stri ng 

stri ng 


problemld = nul 1 ; 
udfld = nul 1 ; 
val ue = nul 1 ; 
valueNumber = null ; 
valueAsNumber = 0; 
valueDate = null ; 
udfListld = null ; 
datecreated = null; 
lastDateUpdated = null; 
lastUpdatedByUser = null; 
createdByUser = null; 


// from problem_text table 


pn 
pri 
pri 
pri 

pri 
pri 

pri 
pri 
pri 
pri 


vate String 
vate String 
vate String 
vate String 

vate String 
vate String 

vate boolean 
vate boolean 
vate boolean 


idseq = nul 1 ; 
textSeq = nul 1 ; 
userld = nul 1 ; 
text = nul 1 ; 

udfDi spl ayType = null; 
name = null; //ddName 

newData = false; 
modifiedData = false; 
deletedData = false; 


vate transient Connection dbconn = null; 
private transient PrintWriter mOut = null; 

// GETTERS 

public String getProblemldO { 
return tni s . probl emld ; 

} 

public String getUdfldQ { 
return this. udfld; 

public String getValueO { 
return this. value; 

} 

public String getval ueNumber() { 
return this. valueNumber; 

public float getval ueAsNumber() { 
return this. valueAsNumber ; 

} 

public Calendar getval ueDateO { 
return this. valueDate; 

} 

public string getudf Listld() { 
return tni s . udf Li stld ; 

} 

public Calendar getDateCreated() { 
return this. datecreated; 
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public Calendar qetLastDateUpdated() { 
return this.lastDateUpdated; 

} 

public String getLastllpdatedByUserO { 
return tnis.lastUpdatedByUser; 

public String getCreatedByliserO { 
return tnis.createdByUser ; 

} 

public String getldSeqO { 
return tnis.idseq; 

public Strinq getTextSeqO { 
return this. textseq; 

* If this udf is a text_area, log_area or text_field, this method will 

* return a string representation of the text. 

V 

public string getTextO { 
return this. text; 

} 

public string getNonOverlappedTextO { 

if (text != null && integer . parselnt(thi s . textSeq) > 1) return 
thi s . text . subst ri ng (z . TEXT_OVERLAP) ; 
else return this. text; 

public Strinq getuserld() { 
return this.userld; 


public String getUDFDi splay Type () { 
return this. udf DisplayType; 


public String getName() { 

if (name == null) Z.log.writeToLog(Z. log. ERROR, "CU: name is null on get") ; 
return this. name; 

public boolean getModifiedData() { 
return this. modi fiedData; 

public boolean getNewData() { 
return this.newData; 

} 

public boolean getDeletedData() { 
return this.deletedData; 

private Calendar timestamp = Cal endar . getlnstance() ; //fn 
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public Calendar getTimestampO { 
return this. timestamp; 

} 

// SETTERS 

public void setProbl emld(Stri ng problemld) { 
this. problemld = problemld; 

} 

public void setudfld(String udfld) { 
this. udfld = udfld; 

public void setvalue(string value) { 
this. value = value; 

} 

public void setval ueNumber(Stri ng val ueNumber) { 
this. valueNumber = val ueNumber; 

this. val ueAsNumber = Float. parseFloat(val ueNumber) ; 

public void setval ueAsNumber (float val ueAsNumber) { 
this. val ueAsNumber = val ueAsNumber; 
this. valueNumber = St ring. val ueof (val ueAsNumber) ; 

public void setval ueDate (Calendar valueDate) { 
this. val ueDate = valueDate; 

} 

public void setudf ListId(Stri ng udfListld) { 
this.udfListld = udfListld; 

} 

public void setDateCreated(Calendar dateCreated) { 
this.datecreated = dateCreated; 

public void setl_astDateUpdated(Calendar lastDateUpdated) { 
this. lastDateUpdated = lastDateUpdated; 

public void setl_astUpdatedByUser(stri ng lastUpdatedByUser) { 
this. lastUpdatedByUser = lastUpdatedByUser; 

public void setCreatedByUser (Stri ng createdByUser) { 
this.createdByuser = createdByUser; 

public void setldseq(String idSeq) { 
this.idseq = idSeq; 

public void setTextSeq(Stri ng textseq) { 
this. textseq = textseq; 

public void setText(stri ng text) { 
this. text = text; 

} 
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public void setUDFDisplayType(String type) { 
this.udfDisplayType = type; 


public void setName(Stri ng name) { 

if (name == null) z.log.writeTol_ogCz.log. ERROR, "PU: name is null"); 
this. name = name; 

} 

public void setTimestamp(Calendar timestamp) { 
this. timestamp = timestamp; 

/*# 

* Sets the value of newData. when executeTransaction(string userld) for this 
Probl em_Rel ease 

* object is executed, newData determines whether an insert is required. If 
this is set to true 

* then this is a new record and it needs to be inserted into the database. 

* @param boolean val 

V 

public void setModifiedData(boolean val) { 
this. modi fiedData = val; 

} 

* Sets the value of newData. When executeTransaction(String userld) for this 
Problem_UDF 

* object is executed, newData determines whether an insert is required, if 
this is set to true 

* then this is a new record and it needs to be inserted into the database. 

* ©pararn boolean val 

V 

public void setNewData(bool ean val) { 
this. newData = val; 

} 

* Sets the value of deletedData. When executeTransaction(Stri ng userld) for 
this Problem_UDF 

* object is executed, deletedData determines if this record should deleted, if 
this is set to true 

* then this record should be deleted from the database. 

* Oparam boolean val 

V 

public void setDeletedData(boolean val) { 
this. deletedData = val; 

} 

public Problem_UDF(String problemld, String pName) { 
this . problemld = problemld; 
this. name = pName; 


/** 

* populateobj populates a Problem_UDF object with the data 

* in HashMap that corresponds to a row in the problem_udf view/ 

* item_udf table 

V 

public void populateobj (Map data) { 

this.udfld = (String) data.get("UDF_lD") ; 
this. value = (string) data.get( M VALUE") ; 
setvalueNumber ((String) data . get ("VALUE_NUMBER") ) ; 
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if (TextManager.isStringVisible((String) data . get ("VALUE_DATE"))) { 
this.valueDate = MetadataXMLUpdater.getcalendar((String) 
data . get ("VALUE_DATE") ) ; 

> 

this.udfListld = (String) data.get("UDF_LlST_ID") ; 

if (TextManager.isStringVisibleC(String) data, get ("DATE__CREATED") ) ) { 
this.datecreated = MetadataXMLUpdater.getCalendar((String) 
data . get ( M DATE_CREATED M )) ; 

if (TextManager.isStringVisible((String) data . get ("LAST_DATE_UPDATED")) ) { 
this.lastDateUpdated = MetadataXMLUpdater .getcalendar((string) 
data . get (" LAST_DATE_UPDATED")) ; 

this.lastUpdatedByUser = (string) data. get ("last_updated_by_user") ; 
this.createdByUser = (String) data. get ( CREATED_BY_USER") ; 
blemld = (String) data. get (ITEM_ID M ) ; 


this.prol 

z . 1 og . wri teToLog (Z . 1 og . DEBUG , " popul ateobj 

z. log. wri teToLog (z. log. DEBUG, "popul ateobj 

Z . 1 og . wri teToLog (Z . 1 og . DEBUG , " popul ateob j 
valueNumber) ; 

Z . 1 og . wri teToLog (Z . 1 og . DEBUG , " popul ateOb j 
valueDate); 

Z. log .wri teToLog (Z. log . DEBUG, " popul ateobj 
udfListld) ; 

Z. log. wri teToLog (z. log. DEBUG, " popul ateobj 
datecreated) ; 

Z . 1 og . wri teToLog (z . 1 og . DEBUG , " popul ateobj 
1 astDateUpdated) ; 

Z . 1 og . wri teToLog (z . 1 og . DEBUG , " popul ateobj 
lastUpdatedByUser) ; 

z . 1 og . wri teToLog (z . 1 og . DEBUG , " popul ateob j 
createdByUser) ; 

Z . 1 og . wri teToLog (Z . 1 og . DEBUG , " popul ateobj 
problemld) ; 

} 

public Problem_UDF(Problem_UDF pUDF) { 


Problemudf udfld " + udfld); 
Problemudf value " + value); 
Problemudf valueNumber " + 


Problemudf valueDate ,f + 
Problemudf udfListld " + 
Problemudf datecreated " + 
Problemudf 1 astDateUpdated 


if 


Problemudf lastUpdatedByUser " + 


Problemudf createdByUser 
Problemudf problemld " + 


ti 


} 


this. problemld = pUDF. problemld; 
this. udfld = pUDF. udfld; 
this. value = pUDF. value; 
this. valueNumber = pUDF. valueNumber ; 
this.valueAsNumber = pUDF. valueAsNumber ; 
this.valueDate = pUDF. valueDate; 
this.udfListld = pUDF. udfListld; 
this.datecreated = pUDF. datecreated; 
this.lastDateUpdated = pUDF.l astDateUpdated; 
this.lastUpdatedByUser = pUDF. lastUpdatedByUser; 
this.createdByUser = pUDF. createdByUser ; 

this.udfDisplayType = pUDF.udfDisplayType; 

this.idseq = pUDF.idSeq; 
this.textseq = pUDF. textseq ; 
this. text = pUDF.text; 
this. name = pUDF.name; 


public Problem_UDF getCloneO { 
Problem_UDF clone = null; 

try { 
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clone = (Problem^UDF) super. cloneO ; 
} catch (Exception e) {; // pass 
} finally { 

return clone; 

} 

} 

* <p> Sets udf text values in hashmap. This is only used by presentation. 

* It sets 2 items in the HashMap. The first item is the 'TEXT' value in the 
problem_text table 

* for udf_id assoicated with this problem id. The second is the value from 

the 

* problem_udf table that is associated with this problem id. This is either 

the 

* value, value_date, value_number or udf_list_id depending on udf_type.</p> 

* Oparam String problemld 

* @param Connection dbconn 

* @param HashMap hash 

V 

public static void setHash(SesameSession session, Connection dbconn, String 
problemld, HashMap hash, 

boolean i ncl udeLoqAreas) 
throws Exception { 

String udfType = null; 
String prevudfld = null; 
String udf Id = null ; 
String udf Name = null; 

String text = null ; 

stringBuffer udf Text = new stri ngBufferO ; 

if (lincludeLogAreas) { 

udfText.append( M select pt.udf_id, id_seq, text_seq, text, u.name "); 

udfText. append (" from udf u, data_dictionary dd, problem_text pt ") ; 

udf Text. append (" where pt . problem_id = ? "); 

udfText .append (" and u.udf_id = pt.udf_id "); 

udfText . append (" and dd.name = u.name ") ; 

udfText. append(" and dd. display_type <> 'LOGAREA' "); 

udfText. append (" order by 1, 2, 3 '); 
} else { 

udfText. append (" select pt.udf_id, id_seq, text_seq, text, u.name from 
problem_text pt, udf u where problem_id = ? "); 

udfText . append (" and u.udf_id = pt.udf_id ") ; 
udfText. append (" order by 1, 2, 3 "); 

} 

StringBuffer udfval = new Stri ngBuffer(" select pu.UDF_lD, VALUE, 

VALUE_NUMBER, VALUE_DATE, pu . UDF_LIST_ID , TITLE, u.name h ) ; 

udfval .append( M from udf_list ul , problem_udf pu, udf u "); 
udfval . append (" where problem_id = ? ") ; 

udfval .append ("and ul . udf_list_id " + Z.dbms.ojequals() + " 
pu.udf_list_id") ; 

udfval . append (" and pu.udf_id = u.udf_id "); 

Preparedstatement statement = dbconn. prepareStatement(udfText . tostri ngO) ; 

statement . setstri ng(l, probl emld) ; 
try{ 

// get long text udfs 
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Resultset result = statement. executeQueryO ; 

StringBuffer sb = null; 
while ( resul t . next() ) { 

udfld = result. getstring("UDF_lD") ; 
udfName = resul t . getstn ng("NAME") ; 
if (resul t.getlnt( rt TEXT_SEQ") > 1){ 

sb.setl_ength(sb.length() - Z.TEXT_0VERLAP) ; 
sb . append(resul t . getst ri ng ("TEXT") ) ; 
} el se { 

sb = new Stri ngBuffer (resul t . getstri ng("TEXT")) ; 

} 

hash. put (udfName, sb. tost ring ()) ; 

} catch (Exception e) { 

ErrorWri ter .write (e, ErrorWri ter . LOG) ; 
} finally { 

statement. close() ; 

} 

Preparedstatement statement2 = dbconn. preparestatement(udfval .toStringO) ; 

statement2 . setst ri ng (1 , probl emld) ; 
// get rest of udfs 
try { 

Resultset resul t2 = statement2 . executeQueryO ; 

while (resul t2 . next()) { 

udfld = resul t2. getstri ng("UDF_lD M ); 
udfName = resul t2 .getstn ng("NAME") ; 

udfType = Z.dictionary.getDisplayType (dbconn, udfName); 
string value = null ; 

// get the value from the correct column, depending on the udf type 
if (DataDictionary.isListType (udf Type)) { 

value = resul t2. getst ri ng ("UDF_LIST_ID") ; 

} else if (udfType. equals ("DATE")) { 

Timestamp dateVal = resul t2. qetTi mestamp("VALUE_DATE") ; 
Calendar date = Convert . tocalendar (dateVal) ; 

DbTime dbt = new DbTi me (session, dbconn); 

if (date != null) { 

dbt . setDbNow(date) ; 

value = dbt .getShortDate() ; ; 

} 

} else if (udfType. equals("NUMBER")) { 

value = resul t2. getst ri ng ("VALUE_NUMBER") ; 

} else { 

value = resul t2. getstri ng("VALUE"); 

} 

if (hash. get (udf Name) != null) { // for multi -valued udfs, add to 
String[] udflist = null; 

if (hash.get(udfName) instanceof string[]) { 

String[] currlist = (String[]) hash . get (udfName) ; 
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udflist = new string [currlist. length + 1]; 
for (int i = 0; i < currlist. length; i++) { 
udflist[i] = currlist[i]; 

} 

udflist[currlist. length] = value; 
} else { 

udflist = new string[2]; 


udflist 


0 


udflist[l] = value; 

} 

hash. put (udf Name, udflist) ; 


= (String) hash. get (udf Name) ; 


} else { // not multi -valued, just put in hashmap 
hash. put(udfName, value) ; 

if ( M DATE".equals(udfType)) { 

hash. put ((udf Name + M _EVDISPLAY") , value); 


} else { 

hash. put ((udf Name + M _EVDISPLAY") , 
result2 .getString("TlTLE")) ; 

} 

} 

} 

} catch (Exception e) { 

ErrorWri ter .wri te(e, ErrorWri ter . LOG) ; 
} finally { 

^ statement2.close() ; 

/ 


* <p> Sets the connection for the object </p> 

* @param dbconn 

V 

public void setConnection(Connection dbconn) { 
this .dbconn = dbconn; 

} 

* <p> Sets the Printwriter for the object </p> 

* @param writer 

V 

public void setPri ntwri ter(Pri ntwri ter writer) { 
this.mout = writer; 

} 

* <p> Checks itself for its display type and sets the appropriate col 
val ue</p> 

V 

public void validate(Connection dbconn, SesameSession session) throws 
val i dati onExcepti on , Excepti on { 

SesameMessageFormat smf = new SesameMessageFormat(dbconn, session); 
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if ("NUMBER". equal s(udfDisplayType)) { 
try { 

Float v = Float. valueof (this. value) ; 
} catch (Number FormatExcepti on e) { 
smf .clear() ; 

smf . appendst ri ng (thi s . val ue) ; 

smf. append ( " is not a valid number."); 

throw new ValidationException(smf .getFormattedMessageO) ; 

} 

setval ueNumber (thi s . val ue) ; 
this. value = null ; 

} else if ("DATE". equal s(udfDisplayType)) { 
java. util .Date date = null; 

try{ 

date = Convert .qetDateFromString(session, this. value); 
if (date == null) throw new ValidationException() ; 

} catch (validationException ve){ 
smf . clear() ; 

smf . appendst ri ng (thi s . val ue) ; 
smf.append(" is not a valid date."); 

throw new ValidationException (smf . getFormattedMessageO) ; 

} catch (Exception e){ 
smf .clear() ; 

smf . appendst ri ng (thi s . val ue) ; 
smf.append(" is not a valid date."); 

throw new ValidationException (smf .getFormattedMessageO) ; 

} 

Calendar cal = Calendar .getlnstance(session.getl_ocale()) ; 

cal .setTime(date) ; 
setval ueDate(cal ) ; 
this. value = null ; 

} else if ("USER". equal s(udfDisplayType)){ 

if ( ! Mi sc . i sAf f i rmati ve (Z . appDef aul ts . getAtt ri bute ("SSO_STATE") ) && 
TextManager . i sst ri ngvi si bl e (thi s . val ue) && 

!SecurityUser.doesUserldExist(dbconn, this. val ue. toUpperCase())){ 
smf .clear() ; 

smf . appendst ri ng (thi s . val ue) ; 
smf.append(" is not a valid user."); 

throw new ValidationException (smf .getFormattedMessageO) ; 

} 


} else if (DataDictionary.isListType(udfDisplayType)) { 
this.udfListld = this. value; 
this. value = null ; 

} else if (DataDictionary.isProblemTextType(udfDisplayType)) { 
this. text = this. value; 
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Probl em_UDF . j ava 

this. value = null ; 


} 


* This method returns the udfld for a specific udf. 

* @param Connection conn 

* ©param String name - the name of the udf. 

V 

// this should eventuallly be moved into udf class 

public static String getUdfld(Connection conn, String name) throws Exception { 
String id = ""; 

String sql = " select udf_id from udf where name = upper(?) "; 
PreparedStatement statement = null; 

try { 

statement = conn. preparestatement(sql) ; 

statement .setst ring (1, name) ; 

ResultSet result = statement . executeQueryO ; 

while (resul t . next()) { 

id = resul t.getstring(l) ; 

} catch (Exception e) { 

return "error retrieving id; " + e; 
} finally { 

statement. close () ; 

} 

return id; 

} 

* Returns the name of the udf for the specific udfld. 

* @param connection conn 

* @param String udfld 

*/ 

public static String getName(Connection conn, String udfld) throws Exception { 
String name = ; 

String sql = " select name from udf where udf_id = ? "; 
PreparedStatement statement = null; 

try { 

statement = conn. preparestatement (sql) ; 

statement. setstring(l, udfld) ; 

ResultSet result = statement. executeQueryO ; 

while (resul t. next()) { 

name = resul t . getstri ng(l) ; 

} catch (Exception e) { 

Errorwri ter . wri te(e , ErrorWri ter . LOG) ; 
} finally { 

statement. close() ; 

} 

return name; 

} 

/ 


* Returns a representation of PROBLEM_UDF and PROBL EM_TEXT tables for the 

* associated probl emld. 

* @param Connection dbconn 
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* @param string problemld 

* ©return ArrayList of 2 Problem_UDF objects. The first represents the values 
i n the 

* PROBl_EM_UDF table ad the second represents the values in the PROBLEM_TEXT. 

*/ 

public static ArrayList getReference(connection dbconn, string problemld) { 

Problem_UDF udf = null; 

ArrayList udfList = new ArrayListO; 

PreparedStatement psl = null; 
Preparedstatement ps2 = null; 

StringBuffer sqll = new Stri ngBuffer () ; 


sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 

sq 
sq 


sq 
sq 
sq 
sq 
sq 


1. 
1. 
1. 
1. 
1. 
1. 
1. 
1. 
1. 
1. 


append (" SELECT PU.UDF_ID UDF, 

append (" pu. value, 

PU. VALUE_NUMBER VNUM, 
PU . VALUE_DATE VDATE, 


//sql 


1. 
1. 
1. 
1. 
1. 


append(" 
append(" 
append (" 
appendC" 
append(" 
append(" 

appendC 
append ( 
l.append(" 


if 


ii 


PU.UDF_LIST_ID VUDF, 

PU . DATE_CREATED CREATED , 

PU . LAST_DATE_U PDATED UPDATED , 

PU . LAST_UPDATED_BY_USER UPDATED_BY, 

PU . CREATED_BY_USER CREATED_BY, 

U.NAME 

DD.DISPLAY_TYPE 


//sql 

sqll. 


appendC" FROM 

appendC" UDF U, 

appendC" PROBLEM_UDF PU 

append( M WHERE PROBLEM_ID = ? 

appendC' AND U.UDF_ID = PU,UDF_ID 
1. appendC" AND DD.NAME = U.NAME 

appendC" order by pu. last_date_updated desc 


// ddName 


"); 


); 


StringBuffer sql2 = new Stri ngBuffer Q ; 


sql2. 
sql2 . 
sql2 . 
sql2 . 
sql2 . 
sql2 . 
sql2 . 
//sql 
sql2 . 
sql2 . 
sql2 . 
sql2 . 
sql2 . 
//sql 
sql2 . 


appendC" SELECT PT.UDF_ID UDF, 
appendC" PT.ID_SEQ, 


appendC 
appendC" 
appendC" 
appendC" 
appendC" 
2. appendC" 


PT.TEXT_SEQ, 

PT.USER_ID, 

PT.TIMESTAMP, 

PT.TEXT, 

U.NAME 

DD . DISPLAY_TYPE 


n 


") 
") 
") 
") 
") 
") 

); 


appendC" FROM ") 

appendC" UDF u, ") 

appendC" PROBLEM^TEXT PT ") 

appendC" WHERE PT. PROBLEM_ID = ? ") 

appendC" and u.udf_id = pt.udf_id ") 

2. appendC" AND DD.NAME = U.NAME 

appendC" order by pt . timestamp desc, pt.udf_id 


// DDNAME 

); 


); 


pt.text_seq ") ; 


try { 

psl = dbconn. prepareStatementCsqll.toStringO); 
psl. setstri ngCl, problemld) ; 

Resultset rsl = psl.executeQueryC) ; 

while Crsl.nextO) { 

udf = new Problem_UDFCproblemld, rsl.getStringC"NAME")) ; 

udf.newData = false; 

udf.udfld = rsl.getstringC'UDF") ; 

udf. value = rsl.getstri ngC"VALUE") ; 
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udf .setValueAsNumber(rsl.getFloat("VNUM")) ; 

udf . valueDate = Convert. toCalendar(rsl.getTimestamp("VDATE")) ; 
udf .udfListld = rsl.getString( M VUDF M ); 

udf .dateCreated = convert. toCalendar(rsl.getTimestamp("CREATED' )); 
udf . lastDateUpdated = 
Convert . toCal endar(rsl.getTimestamp ("UPDATED")) ; 

udf. setLastUpdatedByUser (rsl. getstri ng("UPDATED_BY")) ; 

udf . setcreatedByUse r ( rsl . getstri ng ("CREATED_BY") ) ; 

DDEntry dde = DataDictionary.getDDEntry(dbconn, udf . getNameO) ; 

udf . setUDFDi spl ayType (dde . getDi spl ayType () ) ; 

udf Li st. add (udf) ; 

} 

//close the first set of cursors 

psl.close(); 

rsl.closeO; 

ps2 = dbconn. preparestatement(sql 2 . tostri ng()) ; 
ps2.setstring(l, problemld) ; 
ResultSet rs2 = ps2 . executeQueryO ; 

while (rs2.next()) { 

udf = new Problem_UDF(problemld, rs2.getstring("NAME")) ; 
udf.newData = false; 
udf.udfld = rs2.getString("UDF"); 
udf.idseq = rs2.getString("ID_SEQ") ; 
udf.textseq = rs2 .getstri ng("TEXT_SEQ") ; 
udf.userld = rs2.getString("USER_lD") ; 
udf . lastDateUpdated = 
Convert . toCalendar(rs2 . getTimestamp("TIMESTAMP")) ; 

udf. text = rs2. getst ring ("TEXT") ; 

DDEntry dde = DataDictionary.getDDEntry(dbconn, udf .getNameO) ; 
udf . setUDFDi spl ayType (dde . getDi spl ayType () ) ; 
udfList.add(udf) ; 

} 

ps2 . close() ; 

rs2.close(); 
} catch (Exception e) { 

ErrorWri ter .write (e, ErrorWri ter . LOGERR) ; 
} finally { 

try { 

if (psl != null) psl.closeO; 
if (ps2 != null) ps2.close(); 
} catch (Exception e) {; // pass 

} 

} 

return udfList ; 

} 

* This method gets the value for a udf of type list for a specific problemld 

* and udf Id. This method does involve a trip to the DB to get this value. 

*/ 

public String getudf Li stval ue(Connection dbcon, String problemld, String udfld) 

String sqlstr = null; 
Preparedstatement ps = null; 
ResultSet rs = null ; 
String value = null ; 

sqlstr = " select ul. title title " + 
" from udf_list ul , " + 
" problem_udf pu " + 
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" where pu. problem_id = ? " + 
" and pu.udf_id = ? " + 
" and pu.udf_list_id = ul . udf_Jist_id "; 

try { 

//precompile the ps 

ps = dbcon. prepareStatement (sqlstr) ; 

//set the placeholder 

ps.setstring(l, problemld) ; 

ps.setstring(2 , udfld) ; 

//execute the ps 

rs = ps.executeQueryO ; 

//get the result and check where to put it 
while (rs. next()) { 

value = rs.getstring("title") ; 

} catch (Exception e) { 

ErrorWri ter .write(e, ErrorWri ter . LOGERR) ; 
} finally { 

try { 

if (ps != null) ps.closeO; 
if (rs != null) rs.closeO; 
} catch (Exception e) { 

ErrorWri ter . wri te(e , ErrorWri ter . LOGERR) ; 

}//end try 
return value; 
}//end method. 


* this is for getting multi -valued udf list values 

*/ 

public static ArrayList getudfl_istValues(Connection dbcon, String problemld, 
string udfld) { 

String sqlstr = null; 

Preparedstatement ps = null; 

Resul tset rs = nul I ; 

ArrayList valueList = new ArrayListO; 

string value = null ; 

sqlstr = " select ul . title title " + 
" from udf_list ul , " + 

problem_udf pu " + 
" where pu. problem_id = ? " + 

and pu.udf_id = ? " + 
" and pu. udf_list_id = ul . udf_list_id " + 
" order by ul .title 

try { 

//precompile the ps 

ps = dbcon. preparestatement(sqlstr) ; 

//set the placeholder 

ps.setstring(l, problemld) ; 

ps.setstring(2 , udfld); 

//execute the ps 

rs = ps.executeQueryO; 

//get the result and check where to put it 
while (rs. next()) { 

value = rs.getstring("title") ; 

val ueLi st . add (val ue) ; 

} catch (Exception e) { 

ErrorWri ter .wri te(e , ErrorWri ter . LOGERR) ; 
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} finally { 
try { 

if (ps != null) ps.closeO; 
if (rs != null) rs.closeO; 
} catch (Exception e) { 

ErrorWri ter .write (e , ErrorWri ter . LOGERR) ; 

} 

}//end try 

//Z. probe ("Problemudf getudfListValues valueList " + valueList); 
return valueList; 
}//end method. 


* getLogTimestamp gets the problem text timestamp for log 

*/ 

public static Calendar getl_ogTimestamp(Connection dbconn, String ddName, string 
problemld) { 

String sqlstr = null; 
Preparedstatement ps = null; 
Resul tSet rs = null ; 
Calendar timestamp = null; 

sqlstr = " select pt. timestamp " + 

" from problerrutext pt, udf u M + 
" where u.udf_ld = pt.udf_ld " + 
" and u.name = ? " + 
" and pt.problem_id = ? "; 

try { 

//precompile the ps 

ps = dbconn. preparestatement(sqlstr) ; 

//set the placeholder 

ps.setstring(l, ddName) ; 

ps . setstri nq(2 , problemld) ; 

//execute the ps 

rs = ps.executeQueryO ; 

//get the result and check where to put it 
while (rs.nextO) { 

ti mestamp = convert . tocal endar (rs . getTi mestamp( ,, TlMESTAMP M )) ; 

} catch (Exception e) { 

ErrorWri ter .write (e, ErrorWri ter . LOGERR) ; 
} finally { 

try { 

if (ps != null) ps.closeO; 
if (rs != null) rs.closeO; 
} catch (Exception e) { 

ErrorWri ter .write (e , ErrorWri ter . LOGERR) ; 

}//end try 

return timestamp; 

}//end method. 


* <p> Transactional interface </p> 

* @param problem_id 

V 

public void executeTransaction(stri ng userld) throws Exception { 

z. log.wri teToLoq(z. log. DEBUGl, "Enteri ng Problem_UDF. executeTransaction") ; 
StringBuffer sql = new Stri ngBuf f er () ; 
string sysdate = z . dbms . current_date () ; 
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java. sql .Timestamp timestamp = Convert. toDate (this. times tamp) ; 
PreparedStatement statement = null; 

String udfType = DataDictionary.getDisplayType(dbconn, name); 
//error message 

StringBuffer outErrMsg = new Stri ngBuffer() ; 
outErrMsg . append("<SCRlPT>") ; 

outErrMsg. append("alert(\"There has been an error in adding the data to the 
database. Please contact the system administrator .\") ;") ; 
outErrMsg . append ("</SCRlPT>") ; 

// make sure there is a transaction to execute 
if (! newData && ! deletedData && ImodifiedData) { 

Z. log .wri teToLog(Z. log . DEBUGl, "no di recti ons") ; 

return; 

} 

// no database record exists, so do nothing 
if (deletedData && newData) { 

Z.log.writeTol_og(Z. log. DEBUGl, "both deleted data and new data"); 

newData = false; 

deletedData = false; 

modifiedData = false; 

return; 

} 

if ("USER". equals (udfType) && this. value != null) this. value = 
thi s . val ue . touppercase () ; 

try { 

if (deletedData) { 

Z.log.writeTol_og(Z. log. DEBUGl, "deleting udf id " + this.udfld + " 
from problem " + this. probl emld); 

i f (DataDi cti onary . i sProbl emTextType (udf Di spl ayType) ) { 
sql.append(" delete from probl em_text "); 
sql.append(" where problem_id = ? "); 
sql.append(" and udf_id = ? "); 

statement = dbconn. preparestatement(sql . toStringO) ; 
statement . setstri ng (1, thi s . probl emld) ; 
statement. setst ring (2, this.udfld) ; 
statement . executelipdate() ; 
//update probl emTextHi st 

Probl emudf Hist. updateProblemTextHi st (dbconn, timestamp, 

probl emld) ; 

} else { 

sql.append(" delete from problem_udf "); 
sql.append(" where problem_id = ? ") ; 
sql .append(" and udf_id = ? "); 

statement = dbconn. preparestatement(sql .toStringO) ; 
statement . setstri ng (1 , thi s . probl emld) ; 
statement . setstri ng (2 , thi s . udf Id) ; 
statement . executelipdateO ; 
//update probl emudf Hist timestamp 
// Probl emudf Hi st . updateProbl emudf Hi st (dbconn , ti mestamp , 

problemld) ; 

} 

} else if (newData) { 

Z. log. writeToLog(Z. log. DEBUGl, "inserting udf id " + this.udfld + " 
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+ this. problemld) ; 

if (DataDictionary.isProblemTextType(udfDisplayType)) { 


sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 


. append (" insert into PROBLEM_TEXT 
.append(" (PROBLEM_ID, 


.append( 
. append(" 
.append(" 
. append(" 
.append(" 
.append(" 


UDF_ID, 
ID_SEQ, 
TEXT_SEQ, 
USER_ID, 
TIMESTAMP, 
TEXT) 


. append (" val ues (?,?,?,?,? , ?,?)") ; 


statement 

statement. 

statement. 

statement. 

statement. 

statement. 

statement. 

statement. 

statement. 


= dbconn. prepareStatement(sql . toStringO) ; 
setstri ng(l, this. problemld) ; 

this.udfld); 
this.idSeq) ; 
this. textSeq) ; 
userld); 
setTi mestamp(6 , ti mestamp) ; 
setstring(7, this. text) ; 
executeUpdateQ ; 


setstri ng(2 , 
setstri ng(3, 
setstri ng(4, 
setstri ng(5, 


} 


else 
sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 
// 


{ 


append( 
append( 
append( 
append( 
append( 
append( 
append( 
append( 
append( 
append( 
append( 
append( 


insert into PROBLEM_UDF 

(PROBLEM_ID, 

UDF_ID, 

VALUE, 

VALUE_NUMBER, 
VALUE_DATE , 
UDF„LIST_ID, 
DATE_CREATED, 
L AST_DAT E_U PDATE D , 
LAST_UPDATED_BY_USER , 


it 


n 


ll 


ii 


ll 


ll 


It 


it 


ii 


"); 


CREATED_BY_USER) 

, valuesC?,?,?,?,?,?,?, ?,?,?) "); 
should evaluate data_type before setting variable 
7/ this will eliminate the need for complicated execute routines 
statement = dbconn. preparestatement(sql .toStringO) ; 
statement . setstri ng(l, thi s . probl emld) ; 
statement . setstri ng (2 , thi s . udf Id) ; 
statement . setstri ng (3 , thi s . val ue) ; 
statement . setFl oat C4 , thi s . val ueAsNumbe r) ; 
statement. setTimestamp(5 , (valueDate != null) ? 
Convert. toDate(this. val ueDate) : null) ; 

statement. setstri ng(6, this.udfListld) ; 

statement. setTimestamp(7 , (thi s . datecreated == null ? ti mestamp 
: Convert . toDate(dateCreated))) ; 

statement. setTimestamp(8, (this . lastDateUpdated == null ? 
ti mestamp : Convert . toDate (t hi s . 1 astDateUpdated) ) ) ; 

statement. setstri ng(9, (this. lastUpdatedByUser == null ? userld 
: this . lastUpdatedByUser)) ; 

statement. setstri ng(10, (this.createdByUser == null ? userld : 
this.createdByUser)) ; 

//statement. setst ring (9, userld) ; 

//statement. setstri ng(10, userld) ; 


} 


statement. executeUpdateQ ; 


} else if (modifiedData) { 

Z.log.writeToLog(Z.log.DEBUGl,"updating " + this.udfld + 
problem " + this. problemld) ; 

if ("TEXTAREA". equals (udf DisplayType) | 


ti 


for 
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PRINTTEXT" . equal s (udf Di spl ayType) ) { 


- UM 


// if (this. textseq. equals (new Integer(l) )) { how 

did this ever work ???? - UM 

// why are we just deleting the first one? 
if (this. textseq. equals("r)) { 

sql.append( delete from problem_text "); 

sql.append(" where problenuid = ? "); 

sql.append(" and udf_id = ? ") ; 

2. log.writeToLog(Z.log.DEBUGl, "<===problem udf deletesql= 


+ sql . toStringQ) ; 


problemld) ; 


sql . toStringQ) ; 


} 


statement = v dbconn. preparestatement(sql . tost ring ()) ; 
statement . setst ri ng (1, thi s . probl emld) ; 
statement . setst ri ng (2 , thi s . udf Id) ; 
statement. executeUpdate() ; 
//update probl emTextHi st 

Probl emudf Hi st . updateProbl emTextHi st (dbconn , ti mestamp , 


} 

sq 
sq 

sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 


setLength(O) ; 


append( 
append( 
append( 
append( 
append( 
append( 
append( 
append( 
append( 


insert into problem_text 

(PROBLEM_ID , 

UDF__ID , 

ID_SEQ, 

TEXT_SEQ, 

USER_ID, 

TIMESTAMP, 

TEXT) 

values (?,?,?,?, ?,?,?)"); 


II 
II 
II 
II 
II 
II 
II 
II 


); 


Z. log.writeToLog(Z. log . DEBUGl, "<===problem udf insertsql==> 


ii 


statement 
statement, 
statement, 
statement, 
statement, 
statement, 
statement, 
statement, 
statement, 
else { 


= dbconn. prepareStatement(sql . toStringO) ; 
setstring(l, this. problemld) ; 
setst ri ng (2 , thi s . udf Id) ; 
setstring(3, this.idSeq) ; 
setstring(4, this. textseq) ; 
setstring(5, userld) ; 
setTimestamp(6, ti mestamp) ; 
setstring(7, this. text) ; 
executeUpdate() ; 


sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 
sq 


. append 
.append 
.append 
.append 
.append 
.append 
.append 
. append 
.append 


UPDATE PROBLEM_UDF 
SET VALUE 
VALUE_NUMBER 
VALUE_DATE 
UDF_LIST_ID 
LAST_DATE_UPDATED 
LAST_UPDATED_BY_USER 
WHERE PROBLEM_ID 
AND UDF_ID 


ii 


); 

= ?, "); 

= ? "V 

* i J i 
= 7 M V 

= ?, "); 
= ?,"); 

= ? ") 
= ? ") 


statement = dbconn . preparestatement(sql . tostri ng()) ; 
statement . setst ri ng (1 , thi s . val ue) ; 
statement . setFl oat (2 , thi s . val ueAsNumbe r) ; 
statement. setTimestamp(3, (valueDate != null) ? 
Convert. toDate(this. val ueDate) : null) ; 

statement . setst ri ng (4 , thi s . udf Li stld) ; 
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statement. setTimestamp(5, (this. lastDateUpdated == null ? 
timestamp : Convert. toDate(this. lastDateUpdated))) ; 

statement. setstring(6, (this.lastUpdatedByUser == null ? userld 
: this.lastUpdatedByUser)); 

statement. setstring(7, this.problemld) ; 

statement . setst ri ng (8 , thi s . udf Id) ; 

statement. executeUpdateC) ; 

} 

} 

} catch (Exception e) { 

if (outErrMsg != null) { 
throw e; 

} 

ErrorWriter.wri te(e , Errorwri ter . LOGERR) ; 
} finally { 
try { 

if (statement != null) statement. close() ; 
} catch (Exception e) {; // pass 


* getOneUdfvalue gets the value from a problerruudf record(in HashMap) 

* given the udf Id and displayType 

*/ 

public static String getOneUdfValue(Map rowData, String udf id, String 
displayType) throws Exception { 
String newValue = null; 

try { 

if ("LlST".equals(displayType) || "POPUP" .equals (displayType) || 
"TAB" . equal s (di spl ayType) ) { 

newValue = (string) rowData. get ("UDF_LIST_ID") ; 

} else if (displayType. equals("NUMBER")) { 

newValue = (string) rowData. get ("value_number") ; 

} else if (displayType. equals("DATE")) { 

newValue = (string) rowData.get("VALUE_DATE") ; 

} else { 

newvalue = (string) rowData. get ("VALUE") ; 

} 

} catch (Exception e) { 

Er rorwri ter .write (e, Errorwri ter . LOGERR) ; 
throw e; 

} 

return newValue; 
}//end getoneudf value 

/*# 

* checks if the udf passed in is the same 

V 

public boolean isSame(Problem_UDF pu) throws Exception{ 

if (this. udf Id != pu.udfld) return false; 

if (this.problemld != pu.getProblemldO) return false; 

DDEntry dde = Z. dictionary. getDDEntry(dbconn, name); 
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if (Z. dictionary. isListType(dde) && this.udfListld != pu.udfListld) return 

false; 

else if (Z. dictionary. isProblemTextType(dde)){ 

if (this.getldSeqO != pu.getldSeqO || this.getTextSeqO ! = 
pu.getTextSeqO) return false; 

if (this. text != pu.text) return false; 

else if ("DATE". equal s(dde.getTypeQ) && this.valueDate != pu. valueDate) 
return false; 

else if (this. value != pu. value) return false; 

return true; 

} 

* setUdfHash set all udf in a hash in this form (ddname, value). 

V 

public static void setUdfHash(Connection dbconn, SesameSession session, string 
problemld, HashMap udfHm) throws Exception { 
String value = ""; 
Problem_UDF udf = null; 
String uName = null ; 
String displayType = null; 
ArrayList udfList = new ArrayList(); 
StringBuffer v = new Stri ngBufferQ ; 
string sep = 


try { 

long t = System. currentTimeMillis() ; 
udfList = Problem_UDF.getReference(dbconn, problemld); 
//loop thru thisudfs to get each row of udf info. 
for(int i=0; i<udfl_ist.size() ; i++) { 

udf = (Problem__UDF)udf List .get (i) ; 

displayType = udf .getUDFDi splay Type () ; 

//get the value by displayType 

Z.log.writeToLog(Log. DEBUG, setUdfHash name: " + udf .getName() + " 
displayType:" + displayType);' 

if ("LlST".equals(displayType)) { 

if (udfHm.get(udf .getNameO) != null) { //check if we have gone th 
this udf already. 

//check if it's multi values 

DDEntry dde = Z. dictionary. getDDEntry (dbconn , udf .getNameO) ; 
if (dde. getMulti pi eValueO .equal s("Y f ') ) { 

ArrayList vList = Problem_UDF. getudf Li stvalues (dbconn, 
problemld, udf .getudfld()) ; 

for (int j=0; j<vList.size() ; j++) { 
v. append (vList. get (j)) ; 
v. append(sep) ; 

} 

value = removeLast(v. toStringO) ; 
v. setLength(O) ; 

//Z.log.writeToLog(Log.INFO, n multiple udf value " + value); 
}//end if hm not null 

}else{ 

value = udf .getudf Li stValue(dbconn, problemld, udf . getudf ld()) ; 

}else if ( "TEXTFIELD" . equals (displayType) || 
"URL" .equals (displayType) | | "BOOLEAN". equals (displayType) | | 
M POPUP".equals(displayType) ) { 

value = udf .getvalue() ; 
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}else if ( "NUMBER". equal s(disp I ayType) ) { 

value = udf .getValueNumberO ; 
}else if ( "DATE". equal s(displ ayType) ) { 
Calendar cal = udf .getval ueDateQ ; 
// value = 'Display. formatDate(session , dbconn, 
udf .getval ueDateO) ; 

// let's get the date in the right mask for mdr 
SimpleDateFormat sdf = new simpleDateFormat("MM/dd/yy") ; 
value = sdf . format (cal .getTime()) ; 
}else if ( "TEXTAREA". equal s(displ ayType) || 
"PRINTTEXT". equal s(di spl ayType) ) { 

value = udf .getText() ; 
}else if ( "logarea" . eaual s (di spl ayType) ) { 

value = udf .getTextO ; 
}//end type 
//put value in hashmap 
udfHm. put (udf .getNameQ , value) ; 
}//end for 

getAll Udf s (udfHm) ; 

long t2 = System.currentTimeMillisO ; 
Z.probe("***Time to get udf Hash****" + (t2 - t) ) ; 


}catch (Exception e) { 

ErrorWri ter .wri te(e, ErrorWriter . LOGERR) ; 

throw e; 
}//end try 
}//end setUdfHash 


private static String removeLast (String s) { 
//remove the last ; 
int len = s.length() ; 
string str = ""; 

if (len > 1 ) str= s.substring(0, len - 1); 
return str; 
}//end removeLast 

* getAllUdf gets the udf names from dd to fill out 

* those that have no values in the form. 

V 

private static void getAl lUdfs(HashMap udfHm) throws Exception { 

HashMap diet = DataDictionary.getHashMapO ; 
Iterator iter = dict.keySetO .iterator() ; 
while (i ter . hasNextQ) { 

String key = (string)i ter . next() ; 

DDEntry dde = (DDEntry)di ct . get (key) ; 

if (("UDF".equals(dde.getType()) && (udfHm. get(key) == null))) 
udfHm. put(key, ""); 


}//end getAl 1 udf s 

public String toDisplayStri ng(SesameSession session) throws Exception { 
Securityuser su = (Securi tyUser)session.getAttribute("USER") ; 
Locale locale = session. getLocale() ; 

Z. 1 og. wri teToLoq(Z. log. DEBUG, "PU: name/display type is: " + this.getNameO + "/" 
+ udfDi spl ayType + /" + this.getUDFDisplayTypeQ) ; 
if (DATE . equal s (udf Di spl ayType) ) { 

DbTime dbt = new DbTime(session, getval ueDateQ) ; 

return dbt . getFormattedDate(su . getDateFormat ()) ; 
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} 

else if ("IMAGE". equal s(udfDisplayType)) 

return nul 1 ; 
else if ("LABEL". equal s(udfDisplayType)) 

return getTextO ; 
else if (LIST". equal s(udfDisplayType)) { 

UdfList ul = UdfList .getReference(dbconn, udfListld); 

z. log. writeToLog(z. log. DEBUG, "PU: udf list value is:" + ul .getTi tle()) ; 
return ul .getTi tle() ; 

else if ("LOGAREA". equals (udf DisplayType)) 

return getTextO ; 
else if ( ^NUMBER". equal s(udfDi splay Type)) { 

NumberFormat form = NumberFormat .getlnstance(locale) ; 

return form. format(val ueAsNumber) ; 

else if ("POPUP". equals (udf DisplayType)) 

return getUdfListValue(dbconn, problemld, udf Id) ; 
else if ("PRINTTEXT". equals (udf DisplayType)) 

return getTextO ; 
else if (TAB". equals (udf Display Type)) 

return getudfListValue(dbconn, problemld, udf Id) ; 
else if ( TEXTAREA". equals (udf DisplayType)) 

return getTextO; 
else if (*TEXTFIELD". equals (udf DisplayType)) 

return getTextO; 
else if ( rt USER".equals(udfDisplayType)) 

return SecurityUser .getUserNameDi splay ( dbconn, value, false ); 
else if ("RADlOBUTTON".equals(udfDisplayType)) 

return null ; // ?? 
else if ("CURRENCY". equals(udfDisplayType)) { 

NumberFormat form = NumberFormat .getCurrencylnstance(locale) ; 

return form. format (val ueAsNumber) ; 

else if ("DECIMAL". equals (udf DisplayType)) { 

NumberFormat form = NumberFormat. getlnstance(locale) ; 
return form. format(val ueAsNumber) ; 

return null ; 

} 

} 


r 
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(O) 

COL_SPAN 

NUMBER 



REQUIRED^FLAG 

VARCHAR2 

(D 


DD_NAME 

VARCHAR2 

(30) . 


LABEL_FLAG 

VARCHAR2 

(D 

(0) 

TEXT 

VARCHAR2 

(4000) 

(0) 

TAB INDEX 

NUMBER 




FK< 1)1(1) 1,1 


INTEREST LIST 


ID NUMBER 
FK(1) SECURITY USER ID VARCHAR2 
FK(2)(0) TYPE_ID VARCHAR2 


V 


o, 


0, 


o, 


A 


Note- this index is unique 



LAYOUT.EL EMENT.AT 

TRIBUTE 


m DKD 

LAYOUT_ELEMENT_ID 

NUMBER 


KD 

TYPE 

VARCHAR2 

(20) 

(0) 

VALUE 

VARCHAR2 

(40) 

1(1 )(0) 

DD NAME 

VARCHAR2 

(30) 

Id )(0) 

DD_VALUE 

VARCHAR2 

(40) 

(0) 

RELATION 

VARCHAR2 

(10) 

KD 

EQUIVALENCE 

VARCHAR2 

(10) 



N 


A 


SYSTEM SIGNON 


SYSTEM SIGNQN, jp NUMBER 
FK(1)(0) LOG_TYPE VARCHAR2 (30) 

(O) LOG_MESSAGE VARCHAR2 (1000) 

1(1) LOG_DATE DATE 
l(2)(0) SECURITY.USER ID VARCHAR2 (30) 


CUSTOMER 


CUSTOMER ID NUMBER 

(0) CRM CUSTOMER_CODE VARCHAR2 (30) 

1(1 )(0) CUSTOMER_NAME VARCHAR2 (256) 

l(2)(0) SOUNDEX_CUSTOMER_NAME VARCHAR2 (4) 


-f OF -f 


PROBLEM^UDF 

FK(3)I(1) PROBLEM ID 

NUMBER 


FK(2)I(1) UDFJD 

NUMBER 


(0) VALUE 

VARCHAR2 

(256) 

(O) VALU E_N U MBER 

NUMBER 


(O) VALUE_DATE 

DATE 


FK(1)I(1)<0) UDF_LIST_ID 

NUMBER 


DATE_C R EATED 

DATE 


LAST DATE UPDATED 

DATE 


LAST_UPDATED_BY USER 

VARCHAR2 

(30) 

CREATED_BY_USER 

VARCHAR2 

(30) 

PROBLEM_UDF_TR 


0, 


0, 


Note- this index is unique 


^-0,N- 


-FK(1)0.1_ 


UDF_LIST 

KD 

UDF LIST ID 

NUMBER 


FK(1) 

UDF ID 

NUMBER 


KD 

TITLE 

VARCHAR2 

(40) 


DATE_CREATED 

DATE 



LAST DATE UPDATED 

DATE 



lastIupdated_by_user 

VARCHAR2 

(30) 


CREATED_BY_USER 

VARCHAR2 (30) 

(O) 

OWNER 

VARCHAR2 

(30) 



V 


-0.N 


PROBLEM_TEXT 

FK(3) 

PROBLEM ID 

NUMBER 



ID SEP, 

NUMBER 



IE^T SEQ 

NUMBER 


FK(1) 

UDFJD 

NUMBER 


FK(2) 

USERJD 

VARCHAR2 

(30) 


TIMESTAMP 

DATE 



TEXT 

VARCHAR2 

(4000) 

PROBLEM_TEXT_TR 


>-0,N- 


FK(2)1,1 


-FK(1)1,1- 


-0.N 


0, 


FK(1)1.1 


UDF 


UDF ID 

NUMBER 



DATE CREATED 

DATE 



LAST_DATE_U PDATED 

DATE 



LAST_U PDATED_BY_USER 

VARCHAR2 

(30) 


CREATED BY USER 

VARCHAR2 

(30) 

(O) 

HELP_TEXT 

VARCHAR2 

(2000) 

(O) 

HELP_URL 

VARCHAR2 

(100) 

FK(2) 

PROJECTJD 

NUMBER 


FK(2) 

AREAJD 

NUMBER 


KD 

NAME 

VARCHAR2 

(30) 



-0.N-K 


ALLOWED VALUE TYPE 


TYPE ID NUMBER 

TITLE VARCHAR2 (40) 

(O) PAR EN T_ NAME VARCHAR2 (256) 

CHILD_NAME VARCHAR2 (256) 


U).N- 


< 


1 

FK(1)I(1) 1.1 

• I 
0.N 

k 


SECURITY PERMISSION 


FK(2) SECURITY GROUP ID VARCHAR2 (18) 

FK(1) SECURITY MODULE ID VARCHAR2 (50) 

FK(3) AREA ID NUMBER 

FK(3) PROJECT ID NUMBER 

(O) SECURITY_SELECT_FL VARCHAR2 (1) 

(O) SEC U R ITY_U PDATE_FL VARCHAR2 (1) 


T 


0.N 


0. 


N 


Note- this index is unique 


ALLOWED_VALUES 

FK( 1)1(1) 

TYPE_ID 

NUMBER 


Id )(0) 

PARENT_ VALUE VARCHAR2 

(256) 

KD 

CHILD VALUE 

VARCHAR2 

(256) 

(O) 

SORT_SEQ 

VARCHAR2 

(256) 

(O) 

OWNER 

VARCHAR2 

(30) 

FK(2)I(1) 

AREA ID 

NUMBER 


FK(2)I(1) 

PROJECT ID 

NUMBER 




FK(2 U. 


-FK(2)1,1- 


FK(1 


LI 


SECURITY_MODULE 


SECURITY MODULE ID 

VARCHAR2 

(50) 


SECURITY_MODULE_DESC 

VARCHAR2 

(40) 

(O) 

DESCRIPTION 

VARCHAR2 

(100) 

(O) 

URL 

VARCHAR2 

(255) 

(O) 

MENU_CAT 

VARCHAR2 

(40) 



FK<1 


SECURITY GROUP 


SECURITY GROUP ID VARCHAR2 (18) 
SECURITY_GROUP_NAME VARCHAR2 (40) 


-0,N- 


FK(2)U 


0. 


0. 


1A 


N 


A 


SECURITY_MENU_MODULE 


FK(2) SECURITY MENU ID NUMBER 

FK(1) SECURITY MODULE ID VARCHAR2 (50) 


SECURITY GROUP USER 


FK{2) SECURITY GROUP ID VARCHAR2 (18) 
FK(1) SECURITY USER ID VARCHAR2 (30) 


N 


0, 


FK(2 U. 


SECURITY MENU 


SECURITY MENU ID NUMBER 
1(1) SECURITY MENU_TITLE VARCHAR2 (80) 
SECURITY_MENU_GROUP VARCHAR2 (20) 


DATA_DfCTIONARY 


NAME 

VARCHAR2 

(30) 


TITLE 

VARCHAR2 

(40) 

(0) 

HELP TEXT 

VARCHAR2 

(2000) 

(0) 

HELP URL 

VARCHAR2 

(100) 


REQUIRED FIELD 

VARCHAR2 

(1) 


DATP CREATED 

DATP 



1 ACT nATF 1 IDDATFn 

nATP 

Un 1 C 



1 act DpnATPn RY IICFR 


/7m 


PRFATFn RY 1 ICFR 

VARPWAR? 



7YDP 

1 Trc 


( JU) 


nCCAl 11 T QI"7C 

Kll 1 HJIDCD 

NUWlDtK 



UerAUL l_rUKlw\l 

V/ADrUADI 

VAKC*HAK^ 

\Vj) 


npc&i II T \/AI 1 1C 


( lUU; 


U 1 oFLAT_ r U K MA 1 

V/ADOU AD*> 

VAKt^nAKz 

(10) 

(O) 

UloPLAY_ I Yrb 

VAKCHAK2 

(10) 

(VJ) 

FnlMAKY_oUL 

\/A DO LI ADO 

VAKUHAKz 

t A(\nn\ 
(4UUU) 


UCrtPJUCIN 1 _oUL 


/Annn\ 


ORDPR RY QOI 


^^UUJ 


DAPCMT1 PlfTI n MAUC 
KAKtlN I l_rlfcLU__NArvlt 

\ /ADO U ADO 

(oU) 


PARENT1 <^ni 

\/ARPUIAR9 


(Ol 

PARENT? FIELD NAME 

VARCHAR2 


(01 

PARENT2 SOL 

VARCHAR2 

(40001 


DIRPI AY AS UR( 



(01 

URL 

VARCHAR2 

f 1 0001 


SELECT FOR REPORTS 

VARCHAR2 


(O) 

TABLE NAME* 

VARCHAR2 

(30) 

(0) 

COLUMN NAME 

VARCHAR2 

(30) 

(0) 

ALLOW ADD TO LIST 

VARCHAR2 

(D 

(0) 

LOOKUP TABLE 

VARCHAR2 

(30) 

(0) 

L00KUP.KEY 

VARCHAR2 

(30) 

(0) 

L00KUP_C0LUMN1 

VARCHAR2 

(200) 

(0) 

LOOKUP C0LUMN2 

VARCHAR2 

(30) 

(0) 

LOOKUP C0LUMN3 

VARCHAR2 

(30) 


FILTER_CRITERIA 

VARCHAR2 

(D 

(0) 

PARENT_TABLE 

VARCHAR2 

(30) [ 

(0) 

PARENT, KEY 

VARCHAR2 

(30) 

(0) 

CHILD_KEY 

VARCHAR2 

(30) 

(0) 

EN ABL E J NT ER EST_L 1ST 

VARCHAR2 

(D 


IS_SORTABLE 

VARCHAR2 

(D 


REMEMBER J.AST VAL 

VARCHAR2 

(D 


MULTIPLE. VALUE 

VARCHAR2 

(D 

(0) 

L00KUP_ID 

VARCHAR2 

(30) 



1 

FK<2 1.1 FK(2)I(1)1,1 


SORT ORDER 


SORT ORDER ID NUMBER 
TITLE VARCHAR2 (40) 

DESCRIPTION VARCHAR2 (100) 


OUTPUT_TYPE 

TITLE 

VARCHAR2 

(40) 

DESCRIPTION 

VARCHAR2 

(100) 

DATE.CREATED 

DATE 


LAST DATE UPDATED 

DATE 


LAST UPDATED_BY_USER 

VARCHAR2 

(30) 

CREATED, BY_USER 

VARCHAR2 

(30) 

NAME 

VARCHAR2 

(15) 



FK(2)I(1)1,1 


1 

FK(2 0.1 


0.N 


0, 

A 


SORT ORDER FIELD 


SORT ORDER FIELD ID NUMBER 

FK(2)I(1) SORT_ORDER_ID NUMBER 

FK(1)t(1) DD_NAME VARCHAR2 (30) 

(0) ORDER_RANK NUMBER 

(0) SORT_DIRECTION VARCHAR2 (4) 


V 


o, 


-FK(1)I(1) 1,1- 


A 


REPORT 


REPORT ID 

NUMBER 



LAYOUTJD 

NUMBER 


(0) 

SORT 0RDER_ID 

NUMBER 


FK(3) 

FILTER GROUP.ID 

NUMBER 


(0) 

REP0RTJ3R0UPJD 

NUMBER 


TITLE 

VARCHAR2 

(40) 


DESCRIPTION 

VARCHAR2 

(100) 


SECURITY_GROUP_ID 

VARCHAR2 

(18) 

KD 

SECURITY USER ID 

VARCHAR2 

(30) 


DATE.CREATED 

DATE 



LAST_DATE_U PDATED 

DATE 



LAST U PDATED_BY_U SER 

VARCHAR2 

(30) 


CREATED_BY_USER 

VARCHAR2 

(30) 

FK(2K0) 

OUTPUT TYPE_NAME 

VARCHAR2 (15) 


REPORT_TYPE_NAME 

VARCHAR2 

(15) 



V 

0, 


FK(3)1.1 


FILTER GROUP 


FILTER GROUP ID NUMBER 
TITLE VARCHAR2 (40) 

DESCRIPTION VARCHAR2 (100) 

(O) FILTER_GROUP_TYPE VARCHAR2 (1) 


0, 


USER_SESStON 


SESSION ID 

VARCHAR2 (30) 


SECURITY_USER_ 

.ID VARCHAR2 (30) 


EXPIRE DATE 

DATE 

(0) 

USER_R0LE 

VARCHAR2 (18) 

(0) 

AREAJD 

NUMBER 

(0) 

PROJECT ID 

NUMBER 

(0) 

SITE URL 

VARCHAR2 (100) 



FK(S)I(1)1,1 


0, 


A 


A 


FILTER 


FILTER ID NUMBER 
FK(3)I(1) FILTER_GROUP_ID NUMBER 
FK(2)I(1) DD_NAME VARCHAR2 (30) 


EV_SEQUENCE 


NAME 

VARCHAR2 (40) 

(0) 

MIN_VALUE 

NUMBER 

(O) 

MAX_VALUE 

NUMBER 

(O) 

I NC REMENT_BY 

NUMBER 

(0) 

CACHE^SIZE 

NUMBER 

(O) 

LAST_VALUE 

NUMBER 



FK(1 1,1 


0.N 


A. 


FILTER^CRITERIA 


FILTER CRtTERIA ID NUMBER 
FK(1) FILTERJD NUMBER 

Fl LTER_CR ITERIA^VALU E VARCHAR2 (40) 


DUAL 


1(1 )(0) DUM VARCHAR2 (1) 


APPLICATION DEFAULT 


NAME VARCHAR2 (30) 

(O) VALUE VARCHAR2 (4000) 

(O) COMMENTS VARCHAR2 (64) 


EVCACHE 


EV CACHE ID VARCHAR2 (40) 
(O) CACHE_DATA BLOB (4000) 
(O) TIMESTAMP DATE 
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Overview 

This document defines the current set of "significant" objects that will be created for the 
ExtraView Java (EVJAVA) product. 

Object List 

In the following bulleted list, we list the object by name. If there are any pertinent 
inheritance relationships, then the phrase ":is a <parent-object-name>" is listed next to 
the object's name. The phrase ":has:" or "& has:" indicates that the attributes or 
relationships in the underlying bulleted list belong to the object. 

When a relationship is described, the cardinality is expressed as (1 :x) or (1 :x..y) where x 
is the minimum number of related objects and y is the maximum number of related 
objects. 

These objects do not map 1-1 to the tables in ExtraView. However, the objects were 
chosen so as to imply an obvious mapping to the underlying data. There may be some 
schema changes required to support these objects robustly. 

This is a partial list, and it will be augmented over time; so keep your eye on the date in 
the title. In particular, right now, the security objects and administration objects are not 
well-defined. 

A "(?)" after an attribute or relationship indicates that the field is currently not being 
used, or it is being redesigned, or its meaning is undecipherable from the PL/SQL code 
and the existing schema. 

Note: To reduce clutter, I have factored out the following attributes: Date Created, Date 
Last Updated, Created By User, and Updated By User. These attributes should be part of 
any table that the user can update, and they will be factored in later (somehow). 

Application Logic Objects 

Application logic objects provide the methods necessary for the application logic 
behavior, in addition to the attributes that are maintained in the database for the object. 
The application logic objects should not receive or send HTML, nor should it directly 
access the database. The Presentation Tier and the DBMS Tier protect the application 
logic objects from these external influences. 

Most application logic objects are persistable. The persistence is explicitly invoked for 
each object; every persistable object implements the Persist interface. This is similar to 
Java's Externalizable interface implementation, but the Persist interface gives the 
application full control over which objects are persisted, whereas the Externalizable 
implementation tends to remove this control from the application. 

o Problem: has: 
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o Synopsis 

o Priority (1:1 mapping to Priority) 

o Severity (1:1 mapping to Severity Level) 

o Resolution ( 1 : 1 mapping to Resolution) 

o Originator (=1:1 relationship to User) 

o Component Container (= 1 :0..1 relationship to Component) 1 

o Platform Affected (= 1 :0.. 1 relationship to Platform) 2 

o Product Affected (= 1 :0.. 1 relationship to Product) 3 

o Releases Affected (= 1 :0..n relationship to Release) 

o Description 

o Comments 

o Workaround 

o Release notes 

o (1 :0..n) Enclosure(s) (maintained in Enclosure table) 

o (1 :0.. 1 ) Product Release found 

o (1 :0.. 1) Product Release fixed 

o UDF Values (1 :0..n relationship to UDF Value) 
User 

o Security User Id 

o Last Name 

o Soundex Last Name 

o First Name 

o Security Password 

o Login Message Date 

o Job Title 

o Work Telephone 

o Home Telephone 

o Cell Phone 

o Fax 

o Pager 

o Company Name 

o Address Linel 

o Address Line2 

o City 

o State 

o Postal Code 

o Country 

o Flags (Enabled/Disabled, Notify-On-Own-Updates/Do-Not-Notify) 

o Password Expiry Date 

o Last Access Date 

o Email 


1 1:0.. n in future 

2 l:0..n in future 

3 1 :0..n in future 
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o Email Format 
o Locale 

o Date Format (pattern as used by DateFormatter) 
o Records Per Page 
o Time Zone 

o Group Participation (= 1 :0..n relationship to Security Group) 
o Problem Interest Lists (=1 :0..n relationship to Problem Interest List) 
o Module Interest Lists (=1 :0..n relationship to Module Interest List) 
o Product Interest Lists (=1 :0..n relationship to Product Interest List) 

o Interest List: an abstract base class 

o Users (=1 :0..n relationship to User) 

o Problem Interest List is an Interest List & has: 
o Problem (1:1 relationship to Problem) 

o Module Interest List is an Interest List & has: 
o Module (1:1 relationship to Module) 

o Product Interest List is an Interest List & has: 
o Product (1:1 relationship to Product) 

o Titled Object: an abstract base class 
o ID 
o Name 
o Title 

o Sort sequence (within TitledObjects with same ID) 
o User-Defined Field (aka UDF): is a Titled Object & has: 

o Data Type (Text Field, Text Area, Log Area, Number, Date, List, or URL) 
o Flags: 

D required/optional, 

D display-as-url/display-normal, 

n select-on-reports/no-select-on-reports 
o Help Text 
o Help URL 

o UDF Values (1 :0..n relationship to UDF Value) 
o UDF Value has: 

o Problem Id 
o UDF Id 
o Value 
o Value Number 
o Value Date 

o UDF List Membership (1:1 relationship to UDF List) 

o UDF List : has 
o Title 

o Owning User 

o (1 :0..n relationship to UDF) 
o Component: is a UDF 
o Platform: is a UDF 

*£\ 
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Product: is a UDF 

Description: is a UDF 

Comments: is a UDF 

Workaround: is a UDF 

Release Notes: is a UDF 

Product Line: is a Titled Object & has: 

o Products in the Line (1 :0..n relationship to Product) 
Problem Release (defines l:0..n relationship of Problem to Product Release) 

o Problem ID 

o Product 

o Release Found 

o Release Fixed 

o Short Description 

o Severity Level 

o Priority 

o Status 

o Owner 

o Timestamp 

o Assigned To 

o Hours Billed 

o Privacy 

o Full Description 

o Eng Remarks 

o QA Remarks 

o Alternate Id 

o Public Description 

o Area Id 

o Project Id 

o Category 

o Resolution 

o Product Line Membership (= 1 :0..1 relationship to Product Line) 
o Date Last Status Change 
o Date Closed 
o Contact 
o Originator 
Report 

o Report Name 
o Report Owner 

o Included Report Columns (1 :0..n relationship to Report Column) 
o Sort sequence (1 :0..4 relationship to Report Column) 
Report Column 

o Data Dictionary Element 
o Sort Sequence Number 
o Heading 
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o Flags (break/no-break) 

o Format (?) 
o Message 

o Description (always in English) 

■ o Locale Language 

o Locale Region 

o Locale Variant 

o Text (Unicode): as a MessageFormat pattern 

o Comment 

o Flags (translate/no translate) 
o Icon 

o Description (always in English) 

o Locale Language 

o Locale Region 

o Locale Variant 

o Graphic content 

o Comment 

o Flags (translate/no translate) 
o Enclosure: 

o ID 

o Title 

o Type (user-defined enumeration value) 

o Text (LOB) 

o Product: is a Titled Object & has: 

o Flags (active/inactive) 

o Email Address 

o Soundex 
o Product Release: is a Titled Object & has 

o Defining Product (=1:1 relationship to Product) 

o Category Membership (=1 :0..1 relationship to Category) 

o Release Type (?) 

o Date Of Code Freeze 

o Date Released To QA 

o Date First Customer Ship 

o Flags (Active/Inactive, Available-For-Download/Unavailable-For- 

Download) 
o Release Document Filename (?) 
o Release Directory 

o Module: is a Titled Object & has: 

o Defining Product (=1:1 relationship to Product) 
o Type (=1:1 relationship to Module Type) 
o Default Owner (= 1 :0..n relationship to User) 

o Module Type: is a Titled Object 
o Category: is a Titled Object 
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Resolution: is a Titled Object 
Severity Level: is a Titled Object 
Status: is a Titled Object 
Project: is a Titled Object & has: 

o Area membership (= 1 :CLn relationship to Area) 

Area: is a Titled Object 
Data Dictionary Element 

o Name 

o Title 

o Help Text 

o HelpUrl 

o Flags : 

■ Required/optional, 

■ Display-as-url/display-normal, 

■ select-for-reports/no-select-for-reports 
o Type 

o Default Size 
o Default Format 

* 

o Default Value 

o Display Format 

o Display Type 

o Primary SQL 

o Dependent SQL 

o Order By SQL 

o Parent 1 Field Name (?) 

o Parent 1 SQL (?) 

o Parent2 Field Name (?) 

o Parent2 SQL (?) 

o Url 

o Referenced Table Name (?) 
o Column Name (?) 
Security Group: is a Titled Object & has: 

o User Members (1 :0..n relationship to User) 

o Select Resource Permissions (1 :0..n relationship to Security Resource) = 

"is permitted to select" 
o Update Resource Permissions (1 :0..n relationship to Security Resource) = 

"is permitted to update" 

Security Resource (aka "Security Module") 
o ID 

o Short Description 
o Long Description 
Application Defaults 

o Property Settings (1:1 relationship to Property Set) 


IN 


t c >« ft, n o i o « y 


October 16,2007 

Sesame Proprietary Information 


» 


Sesame Proprietary Information 


o Allowed Values (this needs work. . . imposes hierarchy and constraints on object 
attribute values) 

o Type (1:1 mapping to Allowed Value Type) 

o Parent Allowed Value 

o Child Allowed Value 
o User Globals 

o Security User 

o Current Name Value Pairs (1:1 relationship to Property Set) 
o Template (Sesame infrastructure object) 
o Session 

o JSessionld 

o Property Sets (1 :0..n relationship to Property Set) 
o Property Set 

o Name-Value Pairs (1 :0..n relationship to Name Value Pair) 

Presentation Objects 

The Presentation Servlet Tier contains the objects that are responsible for rendering and 
collecting data from forms sent to/from the browser. This tier has its own set of objects 
which have behavior and lifetimes different from the objects in the application Logic 
Tier. Many of the presentation objects have counterparts in the application logic tier. 
For example, the ProblemDisplay object is directly related to the Problem object. 
However, a Problem object has a long lifetime in the database, whereas the 
ProblemDisplay object lives only for the period of time it takes to interact with the user to 
display, update, or insert the object. 

The Controller object is the top-level action routine that is called to decode and execute 
whatever action is required by the submitted form parameters. In one sense, it is a big 
"switch" that maps the form to an internal action. The following diagram illustrates a 
suggested implementation of the Controller. 
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From Container 




• Process Form (get 
FormParameters) 

• Decode Session 

• Session Invalid -> go to 
LOGIN action 

• Decode Action 














Action Functions 


Fig. : Controller Object Logic 


FormParameters is a transient (non-persistent) object that is re-initialized anew for each 
new form that is submitted. It is a wrapper for the string of parameter values that are 
submitted with the form. Action routines are responsible for the decoding of the 
parameter values (except for those used by the Controller) in FormParameters. 
Most of the presentation objects are transient and can be discarded for each round- trip 
with the client. However, some object state needs to be kept on a per-session basis. The 
SessionContext object can be used to persist state values for the lifetime of the session. 
The SessionContext persisted objects in permanent storage must be garbage-collected on 
an occasional basis, since sessions may disappear quietly. 
The top-level objects are: 
Controller 
My Home Display 
Add Problem Display 
Search Report Display 
Administration Display 
Help Display 
Sign Off Display 
Session Context 
Form Parameters 
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Administration and Configuration Display Objects: 

o 4 User and Security Objects 

o 5 Batch Command Objects 

o 4 Business Rule Objects 

o 10 Installation and Setup Objects 

o 10 Configuration Objects 
Add Problem Display Objects: 

o New Problem Summary Display 

o Interest List Display 

o Edit Problem Display 
Search Report Display Objects: 

o Quick List Display 

o Full Detail Report 

o Summary Report 

o Expanded Query Display 

o Save Query Popup 

o Additional Reports Display 

o Edit Personal Report 

o Add Personal Report 

o Load Saved Query 
Help Objects: 

o ExtraView Help Index Popup 

o Static Help Display 

DBMS Objects 

The DBMS objects implement the DBMS java interfaces that are necessary to support the 
persistence and query functions of the other tiers. The implementing classes are 
determined and loaded at runtime, when the database type and instance are defined in the 
standard Sesame properties file. 

Most of the database independence arises from the use of JDBC for database access. 
However, there are database dependencies in many of the operations performed, e.g., in 
the SQL statements. These can be avoided through the use of ANSI-99 entry-level SQL 
in most cases. The DBMS objects are defined so as to provide support for any required 
functions that are not database-independent. 

The top-level object is the DBMS object, which is a wrapper for all of the methods and 
attributes accessible in the DBMS. The standard Sesame infrastructure to obtain 
connections and manage the database resources is already database-independent; 
therefore, the Sesame framework is used for connection management. The DBMS object 
is used for database functions that differ from one database to another. 

o DBMS: Controls access to the database; loads the classes responsible for 
implementing the DBMS interfaces. Representative methods are: 

o InitializeDBMS: sets up initial parameters and classes based on Sesame 
properties configuration entries. 
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o CreateSequence: creates a named database object that maintains a counter 
for use in defining unique column values (like the Oracle Sequence 
construct). 

o GetSequenceNextValue: bumps the sequence counter by the sequence 

increment and returns the sequence counter value, 
o LOB functions (?) 
o Others tbd 
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ExItiraView Database Tables 


Table_Name Table_Description 


ALLO WE D_VALU ES 

• 

A list of values allowed for a given 
Al 1 o wed_Va 1 ue_Ty pe . 

ALLOWED_VALUE_TYPES 

A list of field types with Allowed_Values. 

APPLICATION_DEFAULT 

System control and configuration for Extra View. 
Each record contains a name of a system 
control variable and the value itself that controls 
a system-wide variable. 

AREA 

> 

Division or department within an organization. 
The entire enterprise is composed of areas, 
and at a lower level, of projects. This is used 
with the PROJECT table to create a hierarchy 
with inheritance for such features as field-level 
security. Area "0" and project "0" control the 
top-level default behavior. Project "1" of Area 
"0" can be defined to have overriding behaviors 
for Area "0", Project "0", but would otherwise 
inherit all behaviors. 

ATTACHMENT 

Metadata about an external attachment, which 
is any MIME-compliant file associated with an 
issue. Zero-to-many attachments are related to 
an issue (the PROBLEM table). 
One ATTACHMENT CONTENT is related to 
an ATTACHMENT. 

ATTACHMENT_CONTENT 

Binary content of an external attachment, which 
is any MIME-compliant file associated with an 
issue through the ATTACHMENT. 

CATEGORY 

The major classification of an issue by business 
purpose. This table contains metadata about all 
possible states for Category. 

CUSTOMER 

Contains basic information about the customers 
associated with issues. 

DATA_DICTIONARY 

The repository and description for meta data for 
all fields and user-definable screen objects, 
including field-level help. 


DB_COOKIE_DATA 

Name-value pair data used for maintaining 
transaction state, a screen aiaiog wm nave a 
set of records that store all the relevant 
information, so that the dialog can continue 
without storing all the information in the screen 
itself. 

FILES 

Contains metadata about external attachments 
stored using the Oracle Application Server 
technique. This has been replaced by the 
ATTACHMENT, ATTACHMENT_CONTENT 
tables for new implementations. 

INTEREST_LIST 

■ 

A table that contains a list of users who are 
interested in receiving emails about an issue or 
who is a member of an interest list defined on a 
Tieid within the system. 

LAYOUT 

Contains information about the design of a 
screen or report. Used by the Layout Editor to 
create Tiexiuie screen ana report layouts. 

LAYOUT_ELEMENT 

Contains information about individual screen or 
report fields in a layout. May be a field, a label 
or a button. 

LAYOUT_ELERflENT_ATTRIBUTE 

Contains specific attribute information about 
individual elements within a layout. For 

V. M a**k MfM f aa«a. 1 a**k. a«J d**a. ^kb. a^Ba. a<J ^Sa. B»a. a***. ■ a**a A**a 4L L»a> aP*a a**, a**ai M*fc .a***. 1 i L*"fc /\ ft » ■ a*S ■ L^N ill ^ ft / 

example, dependencies that control the visiDinty 
of a layout field are stored here. 

LAYOUT_TYPE 

Major classification of layouts by screen or 

a* ^a*. Ma ak aa^aU aLT • a a^>V A a aa. m& i a ji ■ Ba*ai a^^" « ar^L ^» \^ af A ^>a. * a) • 

report function within ExtraView. 

MODULE 

A repeating list of components that typically 
belong to a product and is associated with an 
issue. 

MODULE_TYPE 

Major classification of modules across all 
products. 

PRIORITY 

The relative priority assigned to the resolution 
of an issue. 


m group ot users wno are given access 10 

problems associated with that group name. 

PRIVACY_USER 

A list of users who belong to a privacy group. 




PROBLEM 

Contains information about an issue, problem, 
case, or trouble ticket. This is the core entity in 
ExtraView 

PROBLEM_CASE 

Intersection data associating an issue with a 
particular customer, including the identifier from 
an external CRM system. 

PROBLEM_GROUP 

Intersection data associating multiple, related 
issues for reporting and resolution. Generally, if 
two issues are opened for different customers 

cnnpprninn thp Qamp thinn nr a npw issup is 

OUl lOd I ill iy li IC oal l ic iiiniy, ui a I icvv ioouc io 

opened when proper research would have led 
the person to review an old issue, this provides 
a means of associating and tracking them 

tnnpthpr 

Iv^vU Ivl . 

PROBLEM_HIST 

Contains a history of new, changed, or deleted 
issues. Includes the fields from the PROBLEM 

tahlp aftpr thp rhanap or hpfore the delete 

ICILslw Gild 11 Iw \jI 1 CI 1 I^C, \Jl UwlUI w 11 IO VJvlwlw, 

PROBLEM_MODULE 

Intersection data associating issues to 
modules includina status and to whom it is 

assigned. 

PROBLEM_MODULE_HIST 

A complete record of history information for the 
PROBLEM MODULE 

PROBLEM_RELEASE 

Intersection data associating issues to product 

rpipocpc includina status and to whom it is 

assigned. 

PROBLERfl_RELEASE_HIST 

A complete record of history information for the 

PRHRI FM RFI FASF 
i rwjuLtivi r\LLi_noL, 

PROBLERfl_TEXT 

Contains long text associated with an issue. 

Thp tahlp is mnstrurtpH sn that parh rpnord 

1 1 IC ICIUIC IO vUl IOII UvluU Ow 11 lal CuUI 1 1 vvvl \A 

can contain up to 32k of data. 

PROBLEM_TEXT_HIST 

A complete record of all changes to 

PRORI FM TFXT 

rrSWDLLlVI 1 L_/\ 1 . 

PROBLEWHJDF 

Intersection data associating issues to User 

ueiinea rieias, inciuuing ine lexi, numeno, ur 

date value 

PROBLEM_UDF_HIST 

A complete record of all changes to 
PROBLEMJJDF. 




PRODUCT 

Contains information about a given product. 

r 1 OaUCLS lypiCdiiy UUIltdlll iclcaoco dllU 

modules, and are associated with issues. 

PKUDUCTJJWe 

oontams inTorrnation auoui a plurality ui reidieu 
products. 


I ntorcor*tinn HqIq occnciatinn nrnHiif*tQ to *\ 

I I lid ocOLIUI 1 UdLa dDoUUIdUily [jiuuuvsio iu a 

product line. 

PRODUCT_RELEASE 

Contains information about a named release of 
a given product. 

PROJECT 

An individual project within an Area. The entire 
enterprise is composed of areas, and at a lower 
level, of projects. This is used with the 
PROJECT table to create a hierarchy with 
inheritance for such features as field-level 
security. Area u ana project u control me 
top-level default behavior. Project "1 " of Area 
"0" could be defined as have overriding 

K^howi^re for ArflQ "fl" Prr\ior»f "0" Hi it \A/milH 

Denaviors Tor Area u , rroject u , out wuuiu 

otherwise inherit all behaviors. 

• 


1 lie LrUiUlMMo WIIIOII dlC tU dppCdl Will Mil d ylVCI 1 

system or user-defined report. 

REPORT_SORT 

The sort order for a system or user-defined 
report. 

RESOLUTION 

The list of potential resolutions for a problem. 

ccn IOITTV PDAI lO 
ottUKI 1 Y_UKUUIr 

i ne major grouping ot txtraview users into 
functional security areas. 

ofcLrUKITY_GRUUP_USER 

A list ot tne users oeionging to a oecunty 
Group. 

ecpi IDITV Bflnni II c 
otUUKI 1 Y_luiUUULic 

a single lunciion witnin cxirdview nidi odi i ue 

viewed or updated. 

SECURITY_PERRfllSSION 

A list of read and write permissions to Security 
Modules tor a oecunty oroup. 

CCPI IOITTV 1 ICCP 

oCUUKI 1 Y_UolcK 

An txiraview user, i ms tauie corudiri© dii uie 

data associated with a user, including their 
personal preferences. 

SEVERITYLEVEL 

The list of possible severity levels for a 
problem. 


STATUS 

The list of possible statuses for a problem. 

STATU S_RULE 

A matrix of legal statuses to which a problem 
can be changed, given its current status. This 
can be keyed on areas, project and user group, 
or product. 

SYSTERfi_LOG 

Information about various system events 
oerformed bv users such as Sian On attempts 
and system configuration changes. 

SYSTEM LOG TYPE 

A list of event tvoes that can be loqqed into the 
System Log. 

UDF 

The descriotion of all User Defined Fields in the 
system. 

UDF LIST 

The possible values for a qiven List type User 
Defined Field. 

USERJ3L0BAL 

Information for a user that overrides system 
default settings. 

USER_SESSION 

Information for a particular session for a given 
user, used to track Sign-Ons. 


AlLOWED_VAlUES 

A list of values allowed for a given Allowed_Value_Type. 


Column Name Title Format Text 


CHILD_VALUE 


VARCHAR2(256) 

Allowed value. 

OWNER 


VARCHAR2(30) 

Owner of this allowed 
value. 

PARENT_VALUE 


VARCHAR2(256) 

Parent of allowed 
value. 

SORT_SEQ 


VARCHAR2(256) 

The sequence in 
which the allowed 
values, belonging to a 
certain allowed value 
type, are sorted when 
displayed. 

TYPEJD 


NUMBER 

The identifier of the 
allowed value type to 
which this allowed 
value belongs. 


AllOWED_VAlUE_TYPE 

This table contains a list of field types with Allowed_Values. 


Column Name Title Format Text 


CHILD_NAAAE 


VARCHAR2(256) 

A list of field types with 
ALLOWED_VALUES. 

PARENT_NAME 


VARCHAR2(256) 

Allowed value type. 

TITLE 


VARCHAR2(40) 

Parent of allowed value 
type. 

TYPEJD 


NUMBER 

External name of this 
allowed value type. 


APPLICATION DEFAULT 


This table provides for ExtraView system control and configuration. Each record 
contains a name of a system control variable and the value itself that controls a system- 
wide variable. 


Column Name 

Title 

Format 

Text 

COMMENTS 


VARCHAR2(64) 

Description of this 
application default. 

NAME 


VARCHAR2(30) 

• 

The name of this 
application default. 
A record is uniquely 
identified by its 
name. 

VALUE 


VARCHAR2(4000) 

The value of this 
application default. 


AREA 


This table refers to the division or department within an organization. The entire 
enterprise is composed of areas, and at a lower level, of projects. This is used with the 
PROJECT table to create a hierarchy with inheritance for such features as field-level 
security. Area "0" and project "0" control the top-level default behavior. Project "1" of 
Area "0" can be defined to have overriding behaviors for Area "0", Project "0", but would 
otherwise inherit all behaviors. 


Column Name Title Format Text 


AREAJD 


NUMBER 

A unique 
internal key for 
this area. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
area. 

DATE_CREATED 


DATE 

The date when 
this area was 
created. 

LAST_DATE_UPDATED 


DATE 

The date when 
this area was 
last updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
area. 

TITLE 


VARCHAR2(40) 

External name 
of this area. 


ATTACHMENT , 

Metadata about an external attachment, which is any M I ME-com pliant file associated 
with an issue. Zero-to-many attachments are related to an issue (the PROBLEM table). 
One ATTACHMENT CONTENT is related to an ATTACHMENT. 


Column Name Title Format Text 


ATTACHMENTJD 


NUMBER 

A unique internal 
key for this 
attachment. 

CONTEWTTYPE 


VARCHAR2(100) 

The type of file in 
this attachment. 

CREATED_BY_USER 

■ 

VARCHAR2(30) 

The user who 
created this 
attachment. 

DATE_CREATED 


DATE 

The date when this 
attachment was 
created. 

FILE_DESC 


VARCHAR2(1000) 

Description of the 
file in this 
attachment. 

FILE_NAME 


VARCHAR2(256) 

Name of the file in 
this attachment. 

FILE_SIZE 


NUMBER 

Size in bytes of the 
file in this 
attachment. 

PATH 


VARCHAR2(1000) 

Path of the 
directory from 
which this 
attachment was 
uploaded. 

PROBLEMJD 


NUMBER 

The identifier of 
the issue to which 
this attachment 
belongs. 


I 


ATTACHMENT JX)NTENT 


Binary content of an external attachment, which is any MIME-compliant file associated 
with an issue through the ATTACHMENT. 


Column Name 

Title 

Format 

Text 

ATTACHMENTJD 


NUMBER 

The identifier of the 




attachment to which 




this attachment 




content belongs. 

CONTENT_BLOB 


BLOB(4000) 

The content of the 
attachment. 


CATEGORY 


Category refers to the major classification of an issue by its business purpose. This table 
contains metadata about all possible states for a given Category. 


Column Name Title Format Text 


CATEGORYJD 


NUMBER 

A unique 
internal key for 
this category. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
category. 

DATE_CREATED 


DATE 

The date when 
this category 
was created. 

LASTDATEUPDATED 


DATE 

The date when 
this category 
was last 
updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated 
this category. 

NAME 

* 

VARCHAR2(30) 

The name of 
this category. A 
record is 
uniquely 
identified by its 
name. 

TITLE 


VARCHAR2(40) 

External name 
of this category. 


CUSTOMER 

Contains basic information about the customers associated with issues. 


Column Name Title Format Text 


CRM_CUSTOMER_CODE 


VARCHAR2(30) 

Reference to 
the customer 
code in a CRM 
system to 
which 

Extraview has 
an interface. 

CUSTOMERJD 


NUMBER 

A unique 
internal key for 
this customer. 

CUSTOMER_NAME 

• 


VARCHAR2(256) 

Name of the 
customer. 

SOUNDEX_CUSTOMER_NAME 


VARCHAR2(4) 

Soundex name 
of the 
customer. 


I 


DATA DICTIONARY 


The repository and description for meta data for all fields and user-definable screen 
objects, including field-level help. 


Column Name Title Format Text 


ALLOW_ADD_TO_LIST 


VARCHAR2(1) 

A flag indicating 
that the product is 
or is not allowed 
in a list. 

COLUBflN_NAME 


VARCHAR2(30) 

The column name 
where the data is 
stored inside the 
table defined in 
TABLE JsJAME. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this data 
dictionary entry. 

DATE_CREATED 


DATE 

The date when 
this data 
dictionary entry 
was created. 

DEFAULT_FORftflAT 


VARCHAR2(40) 

The default 
format for display 
of the item. Not 
currently used. 

DEFAULT_SIZE 


NUMBER 

The default size, 
in characters, for 
display of the 
item. Not 
currently used. 

DEFAULT_VALUE 


VARCHAR2(100) 

The default value 
that will populate 
the field in the 
mode where a 
new issue is 
being added. 
This can be 
overwritten to 
remember the last 
value of the field 
for a specific 
user. 






DEPENDENT_SQL 


VARCHAR2(4000) 


DISPLAY_AS_URL 


VARCHAR2(1) 

Y or N to signify 
that the field 
should be 
displayed as a 
link. 

DISPLAY_FORMAT 


VARCHAR2(10) 

The default 
display format 
for the entry. 

DISPLAY_TYPE 

- 

VARCHAR2(10) 

The display type 
of the entry. This 
controls the 
appearance of 
the entry as it is 
displayed on any 
screen or report. 

ENABLEJNTERESTJJST 


VARCHAR2M) 

Indicates whether 
this data 
dictionary entry 
will be available 
for an interest list. 

HELP TEXT 

■ ■ Hi mmm ■ ■ n/\ ■ 


VARCHAR2(2000) 

V/ II \ V«/ 1 1 1 \ 1 \£— \ Cm- \J \J \J 1 

Tool tiDS that 
appear when the 
mouse cursor is 
placed over an 
entry. 

HELPJJRL 


VARCHAR2(100) 

Reference to the 
online help for 
this data 
dictionary item. 

LAST_DATE_U P D ATE D 


DATE 

The date that this 
data dictionary 
entry was last 
uodated 

VI VI V* IV • 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that last 
uodated this data 

Uli/ViVilVvl M IIW V4V4hva 

dictionary entry. 






NAME 


VARCHAR2(30) 

The name of this 

Udid uiisiiuiicny 

value. A record 
identified by its 

namp 

I ICJI 1 IC. 

ORDFR RY ^Ol 


\/ARPHAR9^fin^ 
VnrxUnnrx^^jUUj 


PARFNT1 FIFI D NAMF 


VARPHAR^nn^ 


PARFNT1 ^OL 


\/ARPi-iAR9Mnn^ 


PARFNT2 FIFI n NAMF 

r nrVLli 1 JL rlCLU W Ml VIC 


\/ARPHAR9^n\ 


PARENT2_SQL 


VARCHAR2(4000) 


PRIMARY_SQL 


VARCHAR2(4000) 


RFOIIIRFD FIFI n 



V or M to cionifw 

t or in iu oiyriiiy 

whether the field 
is required. Now 
superseded by a 
layout attribute. 

^A\/F 1 AQT \/AI 1 IP 
OnVC LMO 1 VMLUl 


VARCHAR2(1) 

Y or N. Enables 
ine saving ot ine 

last value set by a 
user for future 
entry into the add 
issue form. 

CCI Cf*T COD DCDHDTC 

otLtu 1 _rUK_KtrUK 1 o 



a nag indicating it 
this data 
dictionary entry 
may be displayed 
on a report. 

TABLE_NAME 


VARCHAR2(30) 

The table name 
where the data is 

c^roH for 

siorea ior ine 
data dictionary 
entry. Used 
along with 

UU LU M IN_IN AM t . 

TITLE 


VARCHAR2(40) 

External name of 
this data 
dictionary item. 


TYPE 


VARCHAR2(30) 

Type of data 

uiciiuridiy iitJiTi. 

Allowed values 
are: DATABASE, 
LABEL, SCREEN 
and UDF. 

URL 


VARCHARPfP'i'^ 

The URL that is 

1 1 lv \J 1 \ 1 — 11 1 CI I 1 0 

used as a link 
from the field to 
another location 
on the network. 


DB_COOKIE_DATA 

Name-value pair data used for maintaining transaction state. A screen dialog will have a 
set of records that store all the relevant information, so that the dialog can continue 
without storing all the information in the screen itself. 

Column Name Title Format Text 


CKEY 


NUMBER 

Session identifier for 
the cookie. The 
session is generally 
a screen dialog 
which completes a 
transaction. The 
CKEY together with 
the CNAME 
uniquely identifies a 
record. 

CNAME 


VARCHAR2(40) 

Name of the cookie. 
The CKEY together 
with the CNAME 
uniquely identifies a 
record. 

C VALUE 


VARCHAR2(4000) 

Value of the cookie. 

CVALUE_LONG 


LONG 

Long value of the 
cookie. 


ENCLOSURE 


Column Name Title Format Text 


CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
enclosure. 

DATE_CREATED 


DATE 

The date when 
this enclosure 
was created. 

ENCLOSUREJD 


NUMBER 

A unique internal 
key for this 
enclosure. 

ENCLOSURE_TEXT 


LONG 

The text of this 
enclosure. 

ENCLOSURE_TYPE_NAME 


VARCHAR2(30) 

The identifier of 
the enclosure 
type to which this 
enclosure 
belongs. 

LAST_DATE_U PDATED 

• 

DATE 

The date when 
this enclosure 
was last 
updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
enclosure. 

PROBLEMJD 


NUMBER 

The identifier of 
the issue to 
which this 
enclosure 
belongs. 

TITLE 


VARCHAR2(80) 

External name of 
this enclosure. 


ENCLOSURE_TYPE 

Column Name Title Format Text 


CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
enclosure type. 

DATE_CREATED 


DATE 

The date that 
this enclosure 
type was 
created. 

LAST_DATE_UPDATED 


DATE 

The date that 
this enclosure 
type was last 
updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
enclosure type. 

NAME 


VARCHAR2(30) 

The name of this 
enclosure type. 
A record is 
uniquely 
identified by its 
name. 

TITLE 


VARCHAR2(40) 

External name of 
this enclosure 
type. 


» 


FILES 

Contains metadata about external attachments stored using the Oracle Application 
Server technique. This has been replaced by the ATTACHMENT, 
ATTACHMENT_CONTENT tables for new implementations. 


Column Name Title Format Text 


DESCRIPTION 


VARCHAR2(1000) 

Description of the file 
attachment. 

FILE_LENGTH 


NUMBER 

The length of the file 
to be uploaded as an 
attachment. 

FILE_NAME 


VARCHAR2(2000) 

The internal name of 
the file to be 
uploaded as an 
attachment. The file 
name is of the 
format: <issue 
number>_<sequence 
number within the 
issue>_<the name of 
the file to be 
uploaded, including 
suffix> 

FILE_TYPE 


VARCHAR2(30) 

The MIME type of 
the file to be 
uploaded as an 
attachment. The file 
type must be one of 
the following: doc, 
htm, jpg, ppt, sql, txt, 
xls. 

ID 


NUMBER 

The identifier of the 
issue to which this 
file belongs. 

OID 

• 

NUMBER 

A unique internal key 
for this file that is 
generated by the 
Oracle Application 
Server. 

SHORT_FILE 


VARCHAR2(100) 

The name of the file 
to be uploaded, 
including suffix. 



• 



TIMESTAMP 


DATE , 

The date and time 
the file was entered 
or last updated. 

USER_NAME 


VARCHAR2(30) 

The name of the 
user that uploaded 
this file. 


INTEREST LIST 


A table that contains a list of users who are interested in receiving emails about an issue 
or who is a member of an interest list defined on a field within the system. 


Column Name 

Title 

Format 

Text 

ID 


NUMBER 

A unique internal 
key for this interest 
list. 

SECURITY JJSERJD 


VARCHAR2(30) 

The identifier of the 
security user to 
which this interest 
list belongs. 

TYPEJD 


VARCHAR2(40) 

The identifier of the 
data dictionary 
name which this 
interest list 
references. 


LAYOUT 

Contains information about the design of a screen or report. Used by the Layout Editor 
to create flexible screen and report layouts. 


Column Name Title Format Text 


AREAJD 


NUMBER 

The identifier of 
the area to 
which this layout 
belongs. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
layout. 

DATE_CREATED 

• 

DATE 

The date when 
this layout was 
created. 

DESCRIPTION 


VARCHAR2(100) 

Description of 
screen or report 
layout. 

GRID_COLS 


NUMBER 

Maximum 
number of 
columns for this 
layout. 

GRID_ROWS 


NUMBER 

Maximum 
number of rows 
for this layout. 

LAST_DATE_UPDATED 


DATE 

The date when 
this layout was 
last updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
layout. 

LAYOUTJD 


NUMBER 

A unique 
internal key for 
this layout. 

PROJECTJD 


NUMBER 

The identifier of 
the project to 
which this layout 
belongs. 


^FPURITY f^ROIIP in 


\/ARPI-IAR9M ft\ 
VniAunnr\t^ 1 O ) 

1 IIC lUCllllllCI Ul 

the security 

LJIUUfJ IU Wl MUM 

this layout 
belongs. 

TEXT 


VARCHAR2(4000) 


TITLE 


VARCHAR2(40) 

External name 
of this layout. 

TYPEJD 


NUMBER 

The identifier of 
the layout type 
to which this 
layout belongs. 


LAYOUT_ELEMENT 

Contains information about individual screen or report fields in a layout. May be a field, a 
label or a button. 


Column Name Title Format Text 


COL_NUM 


NUMBER 

Horizontal 
position of 
layout element. 

COL_SPAN 


NUMBER 

Horizontal span 
of layout 
element. 

CREATED BYUSER 


VARCHAR2(30) 

The user who 
created this 
layout element. 

DATE_CREATED 


DATE 

The date when 
this layout 
element was 
created. 

DD_NAME 


VARCHAR2(30) 

The identifier of 
the data 
dictionary 
element to 
which this layout 
element 
belongs. 

ELEMENTJD 


NUMBER 

A unique 
internal key for 
this layout 
element. 

LABEL_FLAG 


VARCHAR2(1) 

Indicates 
whether label 
must be located 
in standard the 
position next to 
the associated 
field on a 
screen. 






LAST_DATE_UPDATED 


DATE 

The date when 
this layout 
element was 
last updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
layout element. 

LAYOUT ID 


NUMBER 

The identifier of 
the layout to 
which this layout 
element 
belongs. 

REQUIRED_FLAG 


CHAR(1) 

A flag indicating 
that the layout 
element is or is 
not reauired 

ROW_NUM 


NUMBER 

Vertical position 
of lavout 
element. 

ROW_SPAN 


NUMBER 

Vertical span of 
layout element. 

TEXT 


VARCHAR2(4000) 



LAYOUT_ELEMENT_ATTRIBUTE 

Contains specific attribute information about individual elements within a layout. For 
example, dependencies that control the visibility of a layout field are stored here. 


Column Name Title Format Text 


ATTRIBUTE_NAME 


VARCHAR2(40) 

The name of 
this layout 
element 
attribute. The 
attributejiame 
together with 
the 

ELEMENTJD 
uniquely 
identifies a 
record. 

ATTRIBUTE_VALUE 


VARCHAR2(4000) 

The value of this 
layout element 
attribute. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
layout element 
attribute. 

DATE_CREATED 


DATE 

The date when 
this layout 
element 
attribute was 
created. 

ELEMENTJD 

• 

NUMBER 

The identifier of 
the layout 
element to 
which this layout 
element 
attribute 
belongs. 

LAST_DATE_UPDATED 


DATE 

The date when 
this layout 
element 
attribute was 
last updated. 






LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
layout element 
attribute. 


LAYOUTTYPE 

Major classification of layouts by screen or report function within ExtraView. 


Column Name Title Format Text 


CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
layout type. 

DATE_CREATED 


DATE 

The date when 
this layout type 
was created. 

LAST_D AT E_U PD AT E D 

■\ 

• 

DATE 

The date when 
this layout type 
was last 
updated. 

LAST_U P D ATE D_B Y_U S E R 


VARCHAR2(30) 

The user that 
last updated this 
layout type. 

NAME 

• 

VARCHAR2(30) 

Internal name of 
this layout type. 

TITLE 


VARCHAR2(40) 

External name of 
this layout type. 

TYPEJD 

• 

NUMBER 

A unique internal 
key for this 
layout type. 

CREATED_BY_USER 

• 

VARCHAR2(30) 

The user who 
created this 
layout type. 

DATE_CREATED 


DATE 

The date when 
this layout type 
was created. 

LAST_DATE_U PDATE D 


DATE 

The date when 
this layout type 
was last 
updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
layout type. 






NAME 


VARnHAR2^3Ch 

vnr\\ynnr\tyju j 

Infprnal nsmp of 

III LC III CI I IICIIIIw \J\ 

this layout type. 

TITLE 


VARCHAR2(40) 

External name of 
this lavout tvoe 

LI llw IWT WWI llfk/Wi 

TYPEJD 


NUMBER 

A unique internal 
key for this 

lavout tvoe 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 

lax/out tvnp 

DATE_CREATED 


DATE 

The date when 
this layout type 
was created. 

LAST_D ATE_U P D ATE D 

■ 

DATE 

The date when 
this layout type 
was last 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 

Idol UfJUdlCU LI llo 

layout type. 

NAME 

- 


Internal namp of 
iiiidiidi iidiiic? ui 

this layout type. 

TITLE 


VARCHAR2(40) 

External name of 

thte lavout tvoe 

ii no lay vui i.yys^. 

TYPEJD 


NUMBER 

A unique internal 
key for this 
layout type. 


LOOKUP 


Column Name Title Format Text 


LOOKUPJD 


NUMBER 

A unique internal 
key for this lookup. 

LOOKUP_TYPE_ID 


NUMBER 

The identifier of the 
lookup type to which 
this lookup belongs. 

SORT_SEQUENCE 


NUMBER 


TITLE 


VARCHAR2(40) 

External name of 
this lookup. 


I 

I 

LOOKUP TYPE 


Column Name Title Format Text 


AREA 


VARCHAR2(30) 

The user who 
created this 
lookup type. 

CREATED_BY_USER 


DATE 

The date when 
this lookup type 
was created. 

DATE_CREATED 


VARCHAR2(80) 

Description of 
lookup type. 

DESCRIPTION 


DATE 

The date when 
this lookup type 
was last 
updated. 

LAST_D ATE_U P D ATE D 


VARCHAR2(30) 

The user that 
last updated this 
lookup type. 

LAST_UPDATED_BY_USER 


NUMBER 

A unique internal 
key for this 
lookup type. 

LOOKUP_TYPE_ID 


NUMBER 

The identifier of 
the project to 
which this lookup 
type belongs. 

PROJECT 


VARCHAR2(30) 

Type of sort 
performed on 
this lookup type, 
e.g., numeric or 
alphabetic. 

SORT_TYPE 


VARCHAR2(40) 

External name of 
this lookup type. 

TITLE 


VARCHAR2(30) 

The user who 
created this 
lookup type. 


MODULE 

A repeating list of components that typically belong to a product and is associated with 
an issue. 


Column Name Title Format Text 


CREATED_BY_USER 

* 


VARCHAR2(30) 

The user who 
created this 
module. 

DATE_CREATED 


DATE 

The date when 
this module was 
created. 

DEFAULT_OWNER 

Module Owner 

VARCHAR2(30) 

The default 
owner of the 
module, used to 
auto-assign 
issues. 

LAST_DATE_U PDATED 


DATE 

The date when 
this module was 
last updated. 

LAST_UPDATED_BY_USER 

1 


VARCHAR2(30) 

The user that 
last updated this 
module. 

MODULEJD 


NUMBER 

A unique internal 
key for this 
module. 

MODULEJTYPE 

Module Type 

VARCHAR2(12) 

The identifier of 
the module type 
to which this 
module belongs. 

NAME 

Module 

VARCHAR2(40) 

A module is a 
significant part of 
a product. 

PRODUCT_NAME 


VARCHAR2(30) 

The identifier of 
the product to 
which this 
module belongs. 

TITLE 


VARCHAR2(100) 

External name of 
this module. 


MODULE_TYPE 

The major classifications of modules across all products. 


Column Name Title Format Text 


CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
module type. 

DATE_CREATED 


DATE 

The date when 
this module type 
was created. 

LAST_D ATE_U P D ATE D 


DATE 

The date when 
this module type 
was last 
updated. 

LAST_U PDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
module type. 

NAME 


VARCHAR2(12) 

The name of this 
module. A record 
is uniquely 
identified by its 
name. 

TITLE 


VARCHAR2(30) 

External name of 
this module type. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

• 

The user that 
last updated this 
priority. 

NAME 


VARCHAR2(15) 

Internal name of 
this priority. 

PRIORITYJD 


NUMBER 

A unique internal 
key for this 
priority. 

TITLE 


VARCHAR2(30) 

External name of 
this priority. 


PRIORITY 


The relative priority assigned to the resolution of an issue. 


Column Name 

Title 

Format 

Text 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
priority. 

DATE_CREATED 


DATE 

The date when 
this priority was 
created. 

L AST_D ATEJJ P D ATE D 


DATE 

The date when 
this priority was 
last updated. 


) 

i. 
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PRIVACY_GROUP 

A group of users who are given access to problems associated with that group name; 


Column Name 

Title 

Format 

Text 

PRIVACY_GROUP_NAME 


VARCHAR2(30) 

Internal name of 




this privacy 




group. 

PRIVACY J3ROUP_TITLE 


VARCHAR2(80) 

External name of 
this privacy 
group. 


I 


PRIVACY_USER 


A list of users who belong to a privacy group. 


Column Name 

Title 

Format 

Text 

PRIVACY_GROUP_NAME 


VARCHAR2(30) 

The identifier of 
the Privacy Group 
to which this 




privacy user 
belongs. 

SECURITY_USER_ID 


VARCHAR2(30) 

The identifier of 
the security user 
to which this 
privacy user 
belongs. 


PROBLEM 

Contains information about an issue, problem, case, or trouble ticket. This is the core 
entity in ExtraView. 


Column Name Title Format Text 


ALTJD 

Alt ID 

VARCHAR2(30) 

Special format 
issue identifier 
or the legacy 
ID from a 
system from 
which data 
has been 
converted into 
ExtraView. 

AREAJD 

Area 

NUMBER 

The business 
area to which 
this problem 
belongs. 

ASSIGN ED_TO 

Assigned To 

» 

VARCHAR2(30) 

The security 
ID of the user 
to which this 
issue is 
currently 
assigned. 

CATEGORY 

Category 

VARCHAR2(30) 

The category 
of the 
problem. 

CONTACT 

Contact 

VARCHAR2(30) 

The contact 
person for this 
issue. 

DATE_CLOSED 


DATE 

The date when 
this issue was 
closed. 

DATE_CREATED 


DATE 

The date when 
this issue was 
created. 






DATE_LAST_STATUS_CHANGE 

• 

DATE 

The date when 
an issue last 
changed 
status. 1 

HOURS_BILLED 


NUMBER 

Number of 
hours that 
were billed to 
this issue. 

ID 

• 

Problem # 

VARCHAR2(30) 

This is the key 
field by which 
new issues 
are filed. The 
number is 
allocated 
automatically 

do Ulc piUUltJill 

is added. 
Issues may be 
referred to by 
this number. 

LAST_CHANGE_USER 

Changed by 

VARCHAR2(30) 

The last 
person who 
cnangeu inis 
issue. 

ORIGINATOR 

^nginaior 


i i it? ui iy ii idiui 

of the issue. 

OWNER 

Owner 

VARCHAR2(15) 

The owner of 

thic icci io 
Ifllo looUc. 

PRIORITY 

Priority 

VARCHAR2(15) 

The priority of 
the issue. 

PRIVACY 

View 

VARCHAR2(30) 

This field 
determines 
whether the 
issue ts to oe 
displayed 
outside the 
company or 
privacy group. 






t 


PRODUCTJJNE 

Product Line 

VARCHAR2(30) 

The name of 
the product 

line A 

III lv . • » 

product can 
belong to one 
or more 
product lines. 

PRODUCT_NAME 

Product 

VARCHAR2(30) 

The identifier 
of the product 
to which this 
issue belongs. 

PROJECTJD 

* 

Project 

NUMBER 

The identifier 
of the project 
to which this, 
issue belongs. 

RELEASE_FIXED 


VARCHAR2(50) 

The release 
where this 
issue was 
fixed. 

RELEASE_FOUND 

■ 

VARCHAR2(50) 

The release 
where this 
issue was 
found. 

RESOLUTION 

Disposition 

VARCHAR2(30) 

The identifier 

resolution to 
which this 

nrohlpm 

belongs. 

SEVERITY_LEVEL 

Severity 

VARCHAR2(15) 

The severity of 
this issue. 

SHORT_DESCR 

Title 

VARCHAR2(255) 

The title of the . 
problem, as it 
will aoDear on 
a report. 

STATUS 

Status 

VARCHAR2(15) 

The status of 
this issue. 


PROBLEM CASE 


Intersection data associating an issue with a particular customer, including the identifier 
from an external CRM system. 


Column Name 

Title 

Format 

Text 

CRM_CASE_ID 

■ 

VARCHAR2(50) 

Reference to the 
case identifier in a 
CRM system to 
which ExtraVew 
has an interface. 

CUSTOMERJD 


NUMBER 

The identifier of the 
customer to which 
this problem 
belongs in an 
external CRM 
system. 

PROBLEMJD 


NUMBER 

The identifier of the 
issue to which this 
problem case 
belongs. 


PROBLEM_GROUP 

Intersection data associating multiple, related issues for reporting and resolution. 
Generally, if two issues are opened for different customers concerning the same thing, 
or a new issue is opened when proper research would have led the person to review an 
old issue, this provides a means of associating and tracking them together. 


Column Name Title Format Text 


CREATED_BY_USER 

< 

VARCHAR2(30) 

The user who created 
this problem group. 

DATE_CREATED 


DATE 

The date when this 
problem group was 
created. 

LAST_DATE_UPDATED 


DATE 

The date when this 
problem group was last 
updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that last 
updated this problem 
group. 

PROBLEM_GROUP_ID 


NUMBER 

A numeric key. The 
PROBLEMJ3ROUPJD 
together with the 
PROBLEMJD uniquely 
identifies a record. 

PROBLEMJD 


NUMBER 

The identifier of the 
issue to which this 
problem group belongs. 


PROBLEM_HIST 

Contains a history of new, changed, or deleted issues! Includes the fields from the 
PROBLEM table after the change, or before the delete. 


Column Name Title Format Text 


ALTJD 

• 


NUMBER 

Special format 
issue identifier 
or the legacy 
id from a 
system from 
which data 
has been 
converted into 
ExtraView. 

AREAJD 


VARCHAR2(30) 

The identifier 
of the area to 
which this 
issue belongs. 

ASSIGNED_TO 

• 

VARCHAR2(30) 

The security 
ID of the user 
to which this 
issue is 
currently 
assigned. 

CATEGORY 


VARCHAR2(30) 

• 

The category 
of the 
problem. 

CHANGE_TYPE 

- 


CHAR(1) 

Type of 
change: insert, 
update or 
delete (I, U or 
D). 

CONTACT 


VARCHAR2(30) 

The contact 
person for this 
issue. 

DATE_CLOSED 


DATE 

The date 
when this 
issue was 
closed. 






DATE_CREATED 

i 

• 

DATE 

The date 
when this 
issue was 
created. 

DATE_LAST_STATUS_CHANGE 


DATE 

The date 
when an issue 
last changed 
status. 

HISTTIMESTAMP 


DATE 

The date and 
time when the 
issue changed 
status. 

HOURS_BILLED 


NUMBER 

Number of 
hours that 
were billed to 
this issue. 

ID 


NUMBER 

This is the key 
field by which 
new issues 
are filed. The 
number is 
allocated 
automatically 
as the 

|JIUUldll 19 

added. Issues 
may be 
referred to by 
this number. 

LAST_CHANGE_USER 


VARCHAR2(30) 

The last 
person who 

rhannpH thiQ 

KjI 1 CI 1 l\J\7U LI lid 

issue. 

ORIGINATOR 


VARPHARWtfh 

Thp nrininator 

i i \ji iyn iaivi 

of the issue. 




1 1 1© U Wl ICI Ul 

this issue. 

PRIORITY 


VARCHAR2(15) 

The priority of 
the issue. 






PRIVACY 


VARCHAR2(15) 

This field 
determines if 
the issue is to 
be displayed 
outside the 
company of 
privacy group. 

common 
alternatives 
are: PUBLIC 
or PRIVATE. 

PRODUCTJ.INE 

• 

VARCHAR2(30) 

The name of 
the product 

Una A 

line, m 
product can 
belong to one 
or more 
product lines. 

PRODUCT_NAME 

■ 

VARCHAR2(30) 

The identifier 
of the product 
to which this 
issue belongs. 

PROJECTJD 


NUMBER 

The identifier 
of the project 
to which this 
issue belongs. 

RELEASE_FIXED 


VARCHAR2(50) 

The release 
where this 
issue was 
fixed. 

RELEASE_FOUND 


VARCHAR2(50) 

§ 

The release 
where this 
issue was . 
found., 

RESOLUTION 


VARCHAR2(30) 

The identifier 
oi me 

resolution to 
wnicn tnis 
problem 
belongs. 

* 





SEVERITY_LEVEL 

* 


VARCHAR2(15) 

* 

The severity of 
this issue. 

SHORT_DESCR 


VARCHAR2(255) 

The title of the 
problem, as it 
will appear on 
a report. 

STATUS 


VARCHAR2(15) 

The status of 
this issue. 

TIMESTAMP 


DATE 

The date and 
time the issue 
was entered 
or last 
updated. 


PROBLEM_MODULE 

Intersection data associating issues to modules, including status and to whom it is 
assigned. 


Column Name Title Format Text 


ASSIGN ED_TO 

Assigned 

VARCHAR2(30) 

The security ID of 
the user to which 
this module is 
currently 
assigned. 

ID 

■ 

NUMBER 

The identifier of 
the issue to which 
this problem 
module belongs. 

LAST_CHANGE_USER 


VARCHAR2O0) 

The last person 
who changed this 
problem module. 

MODULE! D 

Module 

NUMBER 

The identifier of 
the module to 
which this problem 
module belongs. 

PROBLEM_MODULE_ID 


NUMBER 

The identifier of 
the module to 
which this problem 
module belongs. 

REVERSION 

Version 

NUMBER 

The version of the 
module within 
which the issue 
exists. 

STATUS 

Module Status 

VARCHAR2(15) 

The status of this 
problem for a 
module. 

TIMESTAMP 


DATE 

> 

The date and time 
the problem 
module was 
entered or last 
updated. 


1 


PROBLEM_MODULE_HIST 

This table contains a complete record of history information for the 
PROBLEM_MODULE. 

Column Name Title Format Text 


ASSIGNED_TO 


VARCHAR2(30) 

The security ID of 
the user to which 
this module is 
currently 
assigned. 

CHANGE_TYPE 


CHAR(1) 

Type of change: 
insert, update or 
delete (I, U or D). 

HIST_TIMESTAMP 


DATE 

The date and time 
when the problem 
module changed 
status. 

ID 


NUMBER 

The identifier of 
the issue to which 
this problem 
module belongs. 

LAST_CHANGE_USER 


VARCHAR2(30) 

i 

The last person 
who changed this 
problem module. 

MODULEJD 

■ 

* 

NUMBER 

The identifier of 
the module to 
which this problem 
module belongs. 

PROBLEM_MODULE_ID 


NUMBER 

The identifier of 
the module to 
which this problem 
module belongs. 

RC_VERSION 


NUMBER 

The version of the 
module within 
which the issue 
exists. 

STATUS 


VARCHAR2(15) 

The status of this 
problem for a 
module. 






TIMESTAMP 


DATE 

The date and time 
the problem 
module was 
entered or last 
updated. 


PROBLEM RELEASE 


Intersection data associating issues to product releases, including status and to whom it 
is assigned. 

Column Name Title Format Text 


ASSIGNED_TO 

Release 
Assigned To 

■ 

VARCHAR2(30) 

The security ID 
of the person to 
which this 
problem release 
is assigned. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
problem release. 

DATE_CREATED 

- 

DATE 

The date when 
this problem 
release was 
created. 

LAST_DATE_UPDATED 


DATE 

The date when 
this problem 
release was last 
updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
problem release. 

OWNER 

Release Owner 

VARCHAR2(30) 

The owner of a 

particular 

release. 

PRIORITY 

Priority 

VARCHAR2(15) 

The priority of 
the release. 

PROBLEMJD 

* 

NUMBER 

The identifier of 
the issue to 
which this 
problem release 
belongs. 

PROBLEM_RELEASE_ID 


NUMBER 

A unique internal 
key for this 
problem release. 






PRODUCT NAMF 



The identifier of 

1 1 IV IUVI 1111 Ivl \J\ 

the product to 
which this 
problem release 
belonas 

RELEASE_FIXED 

Version Closed 

VARCHAR2(50) 

The release in 
which the issue 
was fixed 

RELEASE_FOUND 

Version Open 

VARCHAR2(50) 

The release in 
which the issue 
was found. 


UlofJUolUUI 1 

VARPHAR^nn^ 
vrti\wnrtr\t^ou^ 

The identifier of 

1 1 IC IVJvl 111) Id vl 

the resolution to 
which this 
problem release 

helonn^ 

SEVERITY_LEVEL 

• 

Severity 

VARCHAR2(15) 

The severity of a 

Darticular 

release. 

STATUS 

Release Status 

VARCHAR2(15) 

* 

The status of this 
problem for a 
release. 


PROBLEM RELEASE HIST 


This table contains a complete record of history information for the 
PROBLEM RELEASE. 


Column Name 

Title 

Format 

Text 

ASSIGNED_TO 

r 

VARCHAR2(30) 

The security ID 
of the person to 
which this 
problem release 
is assigned. 

CHANGE_TYPE 


CHAR(1) 

Type of change: 
insert, update or 
delete (I, Uor D). 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
problem release. 


DATE_C RE ATE D 


DATE 

The date when 
this problem 
release was 
created. 

HIST_TIMESTAMP 


DATE 

The date and 
time when the 
problem release 
changed status. 

LAST_D ATE_U P D ATE D 


DATE 

The date when 
this problem 
release was last 
updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
problem release. 

OWNER 


VARCHAR2(30) 

The owner of a 

particular 

release. 

PRIORITY 


VARCHAR2(15) 

The priority of 
the release. 






PROBLEM ID 


NUMBER 

1 >1 \J 1 VI LJ I— 1 \ 

The identifier of 
the issue to 
which this 
problem release 
belonas 

PROBLEM_RELEASE_ID 

y 


NUMBER 

A unique internal 
key for this 

problem release. 

■ 

r rxvUUu I l\ Mlwl C 


V/ARPHARW^ 

Thp iHpntifipr of 

the product to 
which this 
problem release 

hplnnn^ 

RELEASE_FIXED 


VARCHAR2(50) 

The release in 
which the issue 
was fixed 

RELEASE_FOUND 


VARCHAR2(50) 

The release in 
which the issue 
was found. 

RESOLUTION 



Thp iHpntifipr nf 

the resolution to 
which this 
problem release 

hplnnn^ 

UCIvl IUO. 

* ♦ 

SEVERITY_LEVEL 


VARCHAR2(15) 

The severity of a 

particular 

release 

STATUS 


VARCHAR2(15) 

The status of this 
problem for a 
release. 


PROBLEM_TEXT 

■ • 

Contains long text associated with an issue. The table is constructed so that each 
record can contain up to 32k of data. 


Column Name Title Format Text 


ID_SEQ 


NUMBER 

p 

The order of this 
text field within the 
issue. 

PROBLEMJD 


NUMBER 

The identifier of the 
issue to which this 
problem text 
belongs. 

TEXT 


VARCHAR2(4000) 

The text describing 
this issue. 

TEXT_SEQ 


NUMBER 

The order of this 
block of text within 
the text field. 

TIMESTAMP 


DATE 

The date and time 
the problem text 
was entered or last 
updated. 

UDFJD 


NUMBER 

The identifier of the 
User Defined Field 
to which this 
problem text 
belongs. 

USERJD 


VARCHAR2(30) 

The identifier of the 
user to which this 
problem text 
belongs. 


PROBLEM_TEXT_HIST 

This table contains a complete record of all changes to PROBLEM_TEXT. 


Column Name Title Format Text 


CHANGE_TYPE 


CHAR(1) 

Type of change: 
insert, update or 
delete (I, U or D). 

HISTJTIMESTAMP 


DATE 

- 

The date and time 
when the problem 
text changed status. 

ID_SEQ 


NUMBER 

The order of this 
text field within the 
issue. 

PROBLEMJD 


NUMBER 

The identifier of the 
issue to which this 
problem text 
belongs. 

TEXT 


VARCHAR2(4000) 

The text describing 
this issue. 

TEXT_SEQ 


NUMBER 

The order of this 
block of text whithin 
the text field. 

TIMESTAMP 


DATE 

The date and time 
the problem text 
was entered or last 
updated. 

UDFJD 


NUMBER 

The identifier of the 
User Defined Field 
to which this 
problem text 
belongs. 

USERJD 


VARCHAR2(30) 

The identifier of the 
user to which this 
problem text 
belongs. 


PROBLEMJJDF 

Intersection data associating issues to User Defined Fields, including text, numeric, or 
date value. 


Column Name Title Format Text 


CREATED_BY_USER 


VARCHAR2(30) 

The user who 1 
created this 
problem User 
Defined Field. 

DATE_CREATED 


DATE 

The date when 
this problem 
User Defined. 
Field was 
created. 

LAST_DATE_U PDATED 

• 

DATE 

The date when 
this User 
Defined Field 
was last 
updated. 

LAST UPDATED BY USER 

■ 

VARCHAR2(30) 

The user that 
last updated this 
problem User 
Defined Field. 

PROBLEMjD 

• 

NUMBER 

The identifier of 
the issue to 
which this 
problem User 
Defined Field 
belongs. 

UDFJD 

• 

NUMBER 

The identifier of 
the User Defined 
Field to which 
this problem 
User Defined 
Field belongs. 

UDFJJSTJD 


NUMBER 

The identifier of 
the User Defined 
Field list to which 
this problem 
User Defined 
Field belongs. 


VALUE 


VARCHAR2(256) 

The text value 
for this User 
Defined Field for 
an issue. 

VALUE_DATE 


DATE 

The date value 
for this User 
Defined Field for 
an issue. 

VALUE NUMBER 


NUMBER 

The numeric 
value for this 
User Defined 
Field for an 
issue. 


PROBLEM UDF HIST 


This table contains a complete record of all changes to PROBLEMJJDF. 
Column Name ' Title Format Text 


CHANGE_TYPE 


CHAR(1) 

Type of change: 
insert, update or 
delete (I, U or 
D). 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
problem User 
Defined Field. 

DATE_CREATED 


DATE 

The date when 
this problem 
User Defined 
Field was 
created. 

HISTTIMESTAMP 

• 

* 

DATE 

The date and 
time when the 
problem User 
Defined Field 
changed status. 

LAST_DATE_U PD ATE D 


DATE 

The date this 
User Defined 
Field was last 
updated. 

LAST_UPDATED_BY_USER 

• 

VARCHAR2(30) 

The user that 
last updated this 
problem User 
Defined Field. 

PROBLEMJD 


NUMBER 

The identifier of 
the issue to 
which this 
problem User 
Defined Field 
belongs. 

UDFJD 


NUMBER 

The identifier of 
the User Defined 
Field to which 
this problem 
User Defined 
Field belongs. 






UDFJJSTJD 

■ 


NUMBER 

♦ 

• 

The identifier of 
the User Defined 
Field list to which 
this problem 
User Defined 
Field belongs. 

VALUE 


VARCHAR2(256) 

• 

The text value 
for this User 
Defined Field for 
an issue. 

VALUE_DATE 


DATE 

The date value 
for this User 
Defined Field for 
an issue. 

VALUE NUMBER 


NUMBER 

The numeric 

■ 11 ■ ■ www w w 

value for this 
User Defined 
Field for an 
issue. 


PRODUCT 


This table contains information about a given product. Products typically contain 
releases and modules, and are associated with issues. 


Column Name Title Format Text 

v 


ACTIVE 


VARCHAR2(1) 

A flag indicating 
that the product 
is active/inactive. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
product. 

DAT E_C RE AT E D 


DATE 

The date when 
this product was 
created. 

EMAIL 


VARCHAR2(50) 

The email 
address that will 
be notified upon 
any changes to 
issues filed for 
this product. 

LAST_DATE_UPDATED 


DATE 

The date when 
this product was 
last updated. 

LAST_UPDATED_BY_USER 

• 

• 

VARCHAR2(30) 

■ 

The user that 
last updated this 
product. 

NAME 

y 


VARCHAR2(30) 

The name of this 
product. A record 
is uniquely 
identified by its 
name. 

PRODUCTJD 


NUMBER 

A unique internal 
key for this 
product. 

SOUNDEX_PRODUCT 


VARCHAR2(4) 

Soundex name 
of the product. 

TITLE 


VARCHAR2(30) 

External name of 
this product. 


PRODUCT LINE 

< 

This table contains information about a plurality of related products. 
Column Name Title Format Text 


CREATED_BY_USER 

• 


VARCHAR2(30) 

The user who 
created this 
product line. 

DATE_CREATED 

• 

DATE 1 

The date when 
this product line 
was created. 

L AST_D ATE_U P D ATE D 


DATE 

The date when 
this product line 
was last 
updated. 

LAST_UPDATED_BY_USER 

■ 

VARCHAR2(30) 

The user that 
last updated this 
product line. 

NAME 


VARCHAR2(30) 

The name of this 
product line. A 
record is 
uniquely 
identified by its 
name. 

PRODUCT_LINE_ID 


NUMBER 

A unique internal 
key for this 
product line. 

TITLE 


VARCHAR2(40) 

External name of 
this product line. 


PRODUCT_PRODUCT_LINE 


This table contains Intersection data associating products to a product line. 


Column Name 

Title 

Format 

Text 

PRODUCT_LINE_NAME 


VARCHAR2(30) 

The identifier of 




the product line to 




which a certain 




product is 




associated. 

PRODUCT_NAME 

» 

VARCHAR2(30) 

The identifier of 
the product to 
which a certain 
product line is 
associated. 


PRODUCT_REI_EASE 

This table contains information about a named release of a given product. 


Column Name Title Format Text 


ACTIVE 

Active 

VARCHAR2(1) 

A flag 

indicating that 
the product 
release is 
active/inactive. 

AVAILABLE_FOR_DOWNLOAD 

• 

Available For 
Download 

VARCHAR2(1) 

Indicates 
whether the s 
product 
release is 
available for 
public 

download from 
an external 
customer 
support 
system. 

CATEGORY 


VARCHAR2(30) 

The category 
of this product 
release. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
product 
release. 

DATE_CODE_FREEZE 

Code Freeze 

DATE 

The date 
when the code 
for this 
product 
release was 
frozen. 

DATE_C REATE D 


DATE 

The date 
when this 
product 
release was 
created. 

DATE_FIRST_CUSTOMER_SHIP 

First Customer 
Shipment 

DATE 

Date product 
was first 
released for 
customer use. 


DATE RELEASE TO OA 

ROA 

DATE 

The date 
when this 
product was 
released to 
QA. 

LAST DATE UPDATED 


DATE 

The date 
when this 
product 
release was 
last updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated 
this product 
release 

NAME 

i 

Release Code 

VARCHAR2(30) 

The name of 
this product 
release. 

PRODUCT_NAME 

• 

w 

• 

VARCHAR2(30) 

The identifier 
of the oroduct 
to which this 
product 
release 
belongs. 

RELEASE 

Release Name 

VARCHAR2(50) 

The name of 
the release. 

RELEASE_DI RECTORY 


VARCHAR2(256) 

j 

The directory 

in which a 

software 

product 

release can 

be found; 

used for an 

external 

customer 

support 

system. 

RELEASE_DOC_FILENAME 

Release File 

VARCHAR2(256) 

Name of 

document for 

external 

product 

support 

system. 


RELEASE_TYPE 

Release Type 

VARCHAR2(80) 

Type of 




release. 


PROJECT 


Refers to an individual project within an Area. The entire enterprise is composed of 
areas, and at a lower level, of projects. This is used with the PROJECT table to create a 
hierarchy with inheritance for such features as field-level security. Area "0" and project 
"0" control the top-level default behavior. Project "1" of Area "0" could be defined as 
have overriding behaviors for Area "0", Project "0", but would otherwise inherit all 
behaviors. 


Column Name Title Format Text 


AREAJD 


NUMBER 

The identifier of 
the area to which 
this project 
belongs. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
project. 

DATE_CREATED 


DATE 

The date when 
this project was 
created. 

LAST_D ATE_U P DATE D 


DATE 

The date when 
this project was 
last updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
project. 

PROJECTJD 


NUMBER 

A unique internal 
key for this 
project. 


REPORT_COLUMNS 

This table contains columns which are to appear within a given system or user-defined 
report. 


Column Name Title Format Text 


BREAK_FL 


VARCHAR2(1) 

Indicates that this 
named report 
column is used as a 
control break in a 
report. 

COL_FORMAT 

/ 

VARCHAR2(30) 

The format of this 
report column. 

COL_HEADING 


VARCHAR2(40) 

The heading of this 
report column. 

COL_NAME 

■ 

VARCHAR2(30) 

Internal name of this 
report column. 

COL_SEQUENCE 


NUMBER 

The sequence in 
which columns are 
displayed on a 
report. 

NAME 


VARCHAR2(60) 

The identifier of the 
report sort order to 
which this report 
column belongs. 

OWNER 


VARCHAR2(30) 

The identifier of the 
user who owns this 
report column. 


REPORT_SORT 

This table contains the sort order for a system or user-defined report. 


Column Name Title Format Text 


CREATED_BY_USER 

* 

VARCHAR2(30) 

The user who 
created this 
report sort order. 

DATE_CREATED 


DATE 

The date when 
this report sort 
order was 
created. 

LAST_D ATE_U P DAT E D 

• 

DATE 

The date when 
this report sort 
order was last 
updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
report sort order. 

NAME 


VARCHAR2(60) 

The name of this 
report sort order. 
A record is 
uniquely 
identified by its 
name. 

TITLE 


VARCHAR2(80) 

External name of 
this report sort 
order. 

VALUE 


VARCHAR2(256) 

The order of the 
columns after 
which the values 
in this report 
should be 
sorted. 


RESOLUTION 

This table contains the list of potential resolutions for a problem. 

Column Name v Title Format Text 


CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
resolution. 

DATE_CREATED 


DATE 

The date when 
this resolution 
was created. 

LAST_DATE_UPDATED 

- 

DATE 

The date when 
this resolution 
was last 
updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
resolution. 

NAME 


VARCHAR2(30) 

i 

The name of this 
resolution. A 
record is 
uniquely 
identified by its 
name. 

RESOLUTIONJD 


NUMBER 

A unique internal 
key for this 
resolution. 

TITLE 


VARCHAR2(30) 

The user who 
created this 
resolution. 


SECURITY GROUP 


This table contains the major grouping of ExtraView users into functional security areas. 


Column Name 

Title 

Format 

Text 

SECURITY_GROUP_ID 


VARCHAR2(18) 

A unique internal 




key for this 




security group. 

S EC U RITY_G RO U P_N AM E 


VARCHAR2(40) 

The external 
name of this 
security group. 


SECURITY_GROUP_USER 


This table contains a list of the users belonging to a Security Group. 


Column Name 

Title 

Format 

Text 

SECURITYJ3ROUPJD 


VARCHAR2(18) 

The identifier of 
the security group 
to which a certain 
security user is 
associated. 

SECURITYJJSERJD 


VARCHAR2(30) 

The identifier of 
the security user to 
which a certain 
security group is 
associated. 


/ 


SECURITY MODULE 


This table contains a single function within ExtraView that can be viewed or updated. 


Column Name 

Title 

Format 

Text 

DESCRIPTION 

i 


VARCHAR2(100) 

* 

Description of 
security module. 

SECURITY_MODULE_DESC 

• 

V 

VARCHAR2(40) 

The external 
name of this 
security module. 

SECURITY_MODULE_ID 


VARCHAR2(50) 

A unique internal 
key for this 
security module. 


SECURITY_PERMISSION 

This table contains a list of read and write permissions to Security Modules for a Security 
Group. 


Column Name Title Format Text 


AREAJD 


NUMBER 

The identifier of 
the area to which 
this security 
permission 
belongs. 

PROJECTJD 


NUMBER 

The identifier of 
the project to 
which this security 
permission 
belongs. 

SECURITY_GROUP_ID 

i 

VARCHAR2(18) 

The identifier of 
the security group 
to which a certain 
security module is 
associated. 

SECURITY_MODULE_ID 


VARCHAR2(50) 

The identifier of 
the security 
module to which a 
certain security 
user is 
associated. 

SECURITY_SELECT_FL 

■ 


VARCHAR2(1) 

A flag indicating if 
a certain security 
group has read 
privileges on a 
certain security 
module. 

SECURITY_UPDATE_FL 


VARCHAR2(1) 

A flag indicating if 
a certain security 
group has update 
privileges on a 
certain security 
module. 


SECURITY_USER 

This table contains all the data associated with an ExtraView user, including their 
personal preferences. 


Column Name Title Format Text 


ADDRESSJJNE1 


VARCHAR2(30) 

The address of 
this user. 

ADDRESSJJNE2 


VARCHAR2(30) 

The address of 
this user 

CELL_PHONE 


VARCHAR2(20) 

The cell phone 
number of this 
user. 

CITY 


VARCHAR2(30) 

The city where 
this user works. 

COMPANY_NAME 

■ 

VARCHAR2(30) 

The name of the 
company where 
this user works. 

COUNTRY 

• 

VARCHAR2(30) 

The country 
where this user 
works. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
security user. 

DATE_CREATED 


DATE 

The date when 
this security 
user was 
created. 

DATE_FORMAT 


VARCHAR2(30) 

The date format 
chosen by this 
user. 

DRILLDOWN_REPORT 


VARCHAR2(30) 


EMAIL 


VARCHAR2(50) 

The email 
address of this 
user. 

EMAIL_FORMAT 


VARCHAR2(30) 

The email 
format chosen 
by this user. 






ENABLEDUSER 

■ 

VARCHAR2(1) 

Indicates 
whether this 
user is enabled. 

FAX 


VARCHAR2(20) 

The fax number 
of this user. 

FIRST_NAME 


VARCHAR2(25) 

The first name 
of this user. 

HOME_TELEPHONE 


VARCHAR2(20) 

The home 
telephone 
number of this 
user. 

JOB_TITLE 


VARCHAR2(30) 

The title of this 
user. 

LANGUAGE 

■ 

VARCHAR2(30) 

The language . 
chosen by this 
user. 

LAST_ACCESS_DATE 

* 

DATE 

The last date 
when this user 
accessed the 
system. 

LAST_D ATE_U P DATE D 


DATE 

The date when 
this security 
user entry was 
last updated. 

LAST_NAME 


VARCHAR2(25) 

Last name of 
the user. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

* 

The user that 
last updated this 
security user 
entry. 

LOGIN_MSG_DT 


DATE 

The date the 
login message 
was last 
updated. 






NOTIFY_ON_OWN_UPDATES 

• 


VARCHAR2(1) 

A flag indicating 
if the user (jets 
notified on 
his/her own 
updates on 
issues. 

PAGER 

* 

VARCHAR2(20) 

The pager 
number of this 
user. 

PASSWORD_EXPIRY_DATE 


DATE 

The date when 
the password of 
this user 
expires. 

POSTAL_CODE 

■ 

VARCHAR2(10) 

The postal code 
of this user. 

RECORDS_PER_PAGE 

■ 


NUMBER 

■ 

The number of 
records that 

I wwi Uw LI IUI 

should be 
displayed per 
page for this 
user 

SECURITY_PASSWORD 

• 

VARCHAR2(13) 

The encrypted 
oassword for 
this user. 

SECURITYJJSERJD 


VARCHAR2(30) 

A unique key for 

this user 

LI llw Uwvl . 

SOUNDEX_LAST_NAME 


VARCHAR2(4) 

Soundex name 
of the user's last 
name. 

STATE 


VARCHAR2(20) 

The state where 
this user works. 

TIMEZONE 


NUMBER 

The time zone in 
which the user 

will hax/p Hatp^ 

win i lave uaico 

displayed. 

USER_ROLE 


VARCHAR2(18) 

The user role of 
this user. 






WORK_TELEPHONE 


VARCHAR2(20) 

The work 




j telephone 




number of this 




user. 


SEVERITY LEVEL 


This table contains a list of possible severity levels for a problem. 

Column Name Title Format Text 


CREATED_BY_USER 


VARCHAR2(30) 

4 

The user that 
last updated this 
severity level. 

DATE_CREATED 


DATE 

The user who 
created this 
severity level. 

LAST_D ATE_U P DATED 


DATE 

The date when 
this severity level 
was created. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The date when 
this severity level 
was last 
updated v 

NAME 

■ 

VARCHAR2(15) 

The name of this 
severity level. 
A record is 
uniquely 
identified by its 
name. 

SEVERITY_LEVEL_ID 


NUMBER 

A unique internal 
key for this 
severity level. 

TITLE 


VARCHAR2(30) 

External name of 
this severity 
level. 


STATUS 


This table contains a list of possible statuses for a problem. 

Column Name Title Format Text 


CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
status. 

DATE_CREATED 


DATE 

The date when 
this status was 
created. 

LAST_DATE_UP DATED 


DATE 

The date when 
this status was 
last updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
status. 

NAME 

* 


VARCHAR2(15) 

The name of this 
status. A record 
is uniquely 
identified by its 
name. 

STATUSJD 

* 

NUMBER 

A unique internal 
key for this 
status. 

TITLE 


VARCHAR2(30) 

External name of 
this status. 


STATUS RULE 

This table contains a matrix of legal statuses to which a problem can be changed, given 
its current status. This can be keyed on areas, project and user group, or product. 


Column Name Title Format Text 


AREAJD 


NUMBER 

The identifier of the area to 
which this status rule belongs. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who created this 
status rule. 

DATE_CREATED 


DATE 

The date when this status rule 
was created. 

LAST_DATE_UPDATED 


DATE 

The date when this status rule 
was last updated. 

LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that last updated this 
status rule. 

PROJECTJD 


NUMBER 

The identifier of the project to 
which this status rule belongs. 

SECURITY_GROUP_ID 


VARCHAR2(18) 

The identifier of the security 
group to which this status rule 
belongs. 

STATUS_FROM 


VARCHAR2(15) 

Current status. The, 
STATUS_FROM/STATUS_TO 
pair determines which status 
changes are allowed, given its 
current status. 

STATUS_TO 


VARCHAR2(15) 

The next status. The 
STATUS_FROM/STATUS_TO 
pair determines which status 
changes are allowed, given its 
current status. 

TYPE 


VARCHAR2(30) 

Type of status rule. Must be 
PRODUCT or USER or 
NONE. 

VALUE 


VARCHAR2(50) 



SYSTEMJ.OG 

This table contains information about various system events performed by users, such 
as Sign On attempts and system configuration changes. 


Column Name Title Format Text 


LOG_DATE 


DATE 

The date and time when 
this event was recorded. 

LOG_MESSAGE 

> 


VARCHAR2(1000) 

A text describing the 
outcome of this event. 

LOG_SEQ 

* 

NUMBER 

f 

A sequence number for the 
logged events. 

LOG_TYPE 


VARCHAR2(30) 

The type of log. Possible 
log types^re: SIGNON, 
SIGNOFF, 

ADD USER RECORD, 
UPDATE USER RECORD, 
ADD PROBLEM, 
UPDATE PROBLEM, 
DELETE_PROBLEM. 

SECURITY_USER_ID 


VARCHAR2(30) 

The user whose action is 
logged. 


SYSTEM_LOG_TYPE 

This table contains a list of event types that can be logged into the system Log. 


Column Name 

Title 

Format 

Text 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
system log type. 

DATE_CREATED 


DATE 

The date when 
this system log 
type was 
created. 

LAST_DATE_UPDATED 

*• 


DATE 

The date when 
this system log 
type was last 
updated. 


LASTJJ PDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
system log type. 

NAME 


VARCHAR2(30) 

Internal name of 
this system log 
type. 

TITLE 


VARCHAR2(40) 

External name of 
this system log 
type. 


UDF 

This table contains the description of all User Defined Fields in the system. 
Column Name Title Format Text 


AREAJD 


NUMBER 

The identifier of 
the area to 
which this User . 
Defined Field 
belongs. 

CREATED_BY_USER 


VARCHAR2(30) 

The user who 
created this 
User Defined 
Field. 

DATE_CREATED 


DATE 

t 

The date when 
this User 
Defined Field 
was created. 

HELP_TEXT 


VARCHAR2(2000) 

Tool tips. 

HELP_URL 


VARCHAR2(100) 

Reference to 
the online help 
for this user- 
defined field. 

LAST_DATE_UPDATED 


DATE 

The date when 
this User 
Defined Field 
was last 
updated. 






LAST_UPDATED_BY_USER 


VARCHAR2(30) 

The user that 
last updated this 
User Defined 
Field. 

NAME 

f 

VARCHAR2(30) 

The name of 
this User 
Defined Field A 
record is 
uniquely 
identified by its 
name. 

PRO ifpt in 


Nl IMRFR 

1 N U 1 VI D [ I \ 

Thp iHpntifipr of 

the project to 
which this User 
Defined Field 
list belongs. 

UDFJD 


NUMBER 

A unique 
internal key for 
this User 
Defined Field. 


UDFJJST 

This table contains the possible values for a given List type User Defined Field. 


Column Name Title Format Text 


CREAJED_BY_USER 


VARCHAR2(30) 

The user who 
created this User 
Defined Field list. 

DATE_CREATED 

■ 

- 

DATE 

The date when 
this User Defined 
Field list was 
created. 

LAST_DATE_UPDATED 


DATE 

The date when 
this User Defined 
Field list was last 
updated. 

LAST_U PD ATED_BY_US ER 

■ 


VARCHAR2(30) 

The user that 
last updated this 
User Defined 
Field list. 

OWNER 


VARCHAR2(30) 

The owner of this 
User Defined 
Field list. 

TITLE 


VARCHAR2(40) 

External name of 
this User Defined 
Field list. 

UDFJD 


NUMBER 

The identifier of 
the User Defined 
Field to which 
this list belongs. 

UDF_LIST_ID 


NUMBER 

A unique internal 
key for this User 
Defined Field list. 


\ 


USER_GLOBAL 

♦ 

This table contains information for a user that overrides system default settings. 


Column Name Title Format Text 


DOMAIN 


VARCHAR2(30) 


NAME 


VARCHAR2(30) 

The name of this 
user global. 

SECURITY_USER_ID 


VARCHAR2(30) 

The identifier of the 
security user to 
which this user 
global entry 
belongs. 

VALUE 


VARCHAR2(4000) 



USERSESSION 

For a given user, information for a particular session used to track sign-ons. 


Column Name Title Format Text 


AREAJD 


NUMBER 

The identifier of the 
area to which this 
user session 
belongs. 

EXPIRE_DATE 

• 

DATE 

The date and time 
when this user 
session expires. 

PROJECTJD 


NUMBER 

The identifier of the 
project to which this 
user session 
belongs. 

SECURITY_USER_ID 


VARCHAR2(30) 

The identifier of the 
security user to 
whom this user 
session belongs. 

SESSIONJD 


VARCHAR2(30) 

A unique internal 
key for this user 
session. 

USER_ROLE 


VARCHAR2(18) 

The role that the 
user has chosen for 
this session. 

* 


^ ' /JO. 
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About This Guide 


The ExtraView Administrator's Guide gives users of the ExtraView Web-based issue 
tracking and workflow management system the knowledge and proficiency needed to 
accomplish two general goals: 

1 . Customize ExtraView to conform to their company's workflow processes, 
business rules, and inter-organizational vocabulary, with all the appropriate data 
fields and security privileges that are required. 

2. Give Administrators the ability to successfully administer ExtraView on an 
ongoing basis in order to efficiently respond to user inquiries, concerns, and 
requests. 

In writing .this guide, we anticipate that the reader is at least somewhat familiar with 
many of the standard issue tracking functions found in ExtraView. Accordingly, this 
guide will assume this familiarity, and will focus on describing the Administrative 
functions of ExtraView. 

Separate guides exist for the installation of ExtraView on your platform (not required if 
you are using Sesame's hosting service), for end users of ExtraView, and for users of 
the Application Programming Interface. 

Guide Organization 

The information in the ExtraView Administration guide is organized in the following 
manner: 


Installation & 
Setup 

Standard 
Configuration 

Users & Security 


This section will give Administrators all of the information 
needed to begin customizing their ExtraView installation. 

Provides information and instructions on how to alter the 
standard ExtraView fields to suit your terminology. 

Provides information on adding users to the system, adding 
user groups to the system, and granting permissions to users 
based on user groups. 


Business Rules & Describes how to use your existing workflow in conjunction with 
Workflow ExtraView. 


Email 

Functionality 


Gives detailed information on all of Extra View's Email 
notification features. 


Notational Conventions 

This guide follows certain notational conventions that are explained below: 

• Terminology that Administrators can customize in ExtraView will be 
marked in italics: 

Select a Product from the list. 

• Names of buttons, links, lists, or fields will appear in bold: 
Select a value from the Owner dropdown list. 

• Whenever there are multiple steps involved in achieving a certain 
result, these will be noted numerically: 

1. Click the Edit button. 

2. Select a value from the list. 

3. Click the Update button. 
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INTRODUCTION 


ExtraView Product Description 


ExtraView is a Web-based issue tracking system that is designed to meet the 
following objectives: 

• Easy to install, configure and administer, minimizing your 
organization's setup and ongoing cost of ownership 

• Provide functionality that is easily extensible over time 

• Able to support your processes and your workflow, without major 
modification 

• Scalable to support large numbers of users and issues 

• Easily customized to reflect your company's terminology, and data 
hierarchies, and able to provide extensive validation for data that 
describes your organization, products, and services 

Key Concept for Understanding ExtraView 


ExtraView Installation and Setup 

This is a process that is best executed with some advance planning. This 
purpose of this guide is to give you complete details on the administrative . 
portion of the initial setup and as well as ongoing support for your installation. 
The basic workflow suggested for setting up your installation is as follows: 

• Plan your server hardware and network connectivity to support 
ExtraView. Sesame's technical support personnel can help with 
recommendations for suitable platforms 

• Install Oracle and the Web server software on this hardware, and 
establish communications on your company's network or over the 
Internet 

• Install the ExtraView application within Oracle. Please refer to the 
appropriate ExtraView installation guide for your platform 

• Set up ExtraView. This Administrator's Guide covers the design of 
your system and how to provide the features you need for your 
company. Briefly, these are: 

o Defining and implementing the various groups or categories of 
users who will access the system 
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o Defining and creating the fields in your system 
o Defining the relationships between fields 

o Designing and laying out screens to support the fields you 
create 

o Creating a structure of permissions that support access to 
each screen for each user group that was defined 

o Setting up the workflow you want to use to control the 
processes in your company 

o Designing standard reports for your users 

o Adding user accounts to the system 

o Testing the completed system 

Defining a Process That Works for Your Company 

ExtraView allows the System Administrator to define a process that conforms 
to the way the company works. It does not impose a fixed methodology on 
the company. The administrator can, without programming, set up rules 
appropriate to the company's needs. 

Each issue you submit can be moved between any number of states, with 
each state being visible only to the group of users that are working on an 
individual state. For example, an open problem may only be viewed by the 
engineering group, who may only mark it fixed or problem not found after 
working on it. They could not, for example, close the problem since that is a 
state defined to a different user group. 

A user group is created for all people who should follow the same rules. 
Typically these would fall along the lines of customers, support staff, 
engineering, quality assurance, etc., but complete flexibility exists to define 
what user groups you create and how many you create. 

Should you have a workflow process that cannot be accommodated within 
ExtraView's standard functionality, the product can be simply extended with 
additional source code. ExtraView was designed to make it easy to alter or 
add functionality within the source code. 


Data Dictionary 

The data dictionary is the central place where all field definitions are stored 
and maintained. In addition, this core component of ExtraView controls many 
of the attributes of each field, such as its display type, display title, whether 
the field is selectable on reports, the SQL used to populate the field if it's a 
list, default value, and help text. 
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Flexibility of the User Interface 

ExtraView can be modified in a number of ways in order to tailor its look and 
feel to any company's needs. 

The following changes can be made simply, either by you or by Sesame 
Technology: 

• Alter screen colors and fonts 

• Place the system menu horizontally or vertically on the screen 

• Add your company logo 

• Edit all text labels to reflect your own terminology 

• Rename, add, or delete menu items 

• Create new menu buttons in any style 

User Groups and the Security System 

This inter-related group of concepts is central for understanding ExtraView. 
Individual users belong to one or more user groups and share the same 
characteristics and permissions. For example, one user group may have 
read and write access to a particular field, while another group may only be 
able to view the same field, while still another group may not even be able to 
see the same field. 

Any field that is available in ExtraView has a security key to protect it. They 
can either be whole menus, or individual fields within a screen. For example, 
a security key exists for accessing the security module itself. Another 
security key exists for the product menu item on the Administration menu. 
Another example is that a security key exists to control access to the 
description field. Basically, all of the fields that are visible on ExtraView can 
be turned on or off based on user group privileges. 

The Grant Security Privileges section controls all these accessibility features 
in your version of ExtraView. In a matrix view, the intersection of the security 
key and the user group is a read and write switch. Therefore, for every item 
that has a defined security key, you can allow or prohibit any user group to 
access that feature. 


Screen & Report Layout Editor 

This component of the administration allows you to set up and alter the layout 
of the Add Problem and Edit Problem screens. In addition, key reports such 
as the Quick List and the Detailed Report also use layouts defined by this 
function. Different layouts can be defined for different user groups within your 
system, offering a tremendous amount of flexibility. Each layout works in 
conjunction with security permissions for each field. Therefore, an important 
concept to understand is that simply placing a field on a screen does not 
automatically give all users the ability to read or write to the field. Using the 
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Grant Security Privileges option allows you to define which fields are visible 
and updateable to each group of users. The security privilege for the field 
overrides the fact that a field may be placed on a screen or report. 


Interest Lists 

These are a powerful feature of ExtraView, ensuring automatic notification of 
events to appropriate individuals within an organization. Interest lists can be 
defined within the data dictionary on any field that may have a list of values. 
For example, you may define an interest list that notifies individuals on all 
issues that have a severity level of critical, or you may define an interest list 
that notifies individuals whenever an issue affects a particular module. 


Reporting 

Within the ExtraView administration, Reports can be defined to be available 
to the entire community of users. Reports can be simply a set of filters that 
are used to query the ExtraView database, or they can be coupled with 
internal or customized layouts. 


Application Programming Interface (API) 

The API to ExtraView allows the user to extend ExtraView's functionality. 
The key features of the API are: 

• A full Command Line Interface (CLI) that allows users to access 
functions such as adding, updating, deleting and searching from a 
command line. This is typically used from a UNIX, Linux or Windows 
NT command shell. 

• A set of URL functions which access ExtraView to perform functions. 
This eliminates the need for expensive software such as SQLNet on 
each client computer. 

• An extendible interface allowing the user to create additional functions 
with source code. This can be used, for example, to integrate other 
applications, such as CRM and SCM directly into ExtraView. 


INSTALLATION & SETUP 
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The ExtraView Installation and Setup features are designed to provide the System 
Administrator with a toolset for making even the most highly custom design and 
configuration requirements easy to implement, with little or no programming required. 

These same features also make it possible for the Administrator to continue to 
customize and refine the system to better conform to the company's changing needs, 
with little or no downtime. 

Note: Because initial installation and setup requirements will normally have been 
implemented by the Sesame Technical Support team at the time of license, it may be 
advisable for the System Administrator interested in first learning day-to-day system 
management functions to skip this chapter for now , and begin instead with chapter 2 } 
Users and Security. 

< 

System Customization 

The following topics will guide you through your ExtraView customization process: Data 
Dictionary, User-Defined Fields, Layout Editor, Allowed Value Types, Sign On Message, 
Behavior Settings, Usage Statistics, Configuration Settings, User Roles, Home Screen, 
and Editing Personal Options. 

Installation Setup 

This section allows you to set up and modify system level information that is 
used throughout the ExtraView system. This is one of the key places where 
installation information is altered. A Sesame Technology representative will 
enter most of this information for greater customer convenience. 


1 . Installation Setup is found under the Installation & Setup sub-heading on 
the Administration menu. 
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ExtraView Administration 


Users & Security 

i£> ►Jsor Accounts 

System Security Keys 
<d Privacy Groups 

Batch Commands 

® Change 3 Problem Owner 
<© Change :» Problem Originator 
© Changs a Problem Module 

Business Rules & Workflow 

® SUte Change Rubs 


Installation & Set 

<*> User Defined Fields 
© Scr^n and Report Layout Types 
O Saved Values 
© Usage Statistics 
$ User Reports 
4> ExtraView Licence 

Configuration 

Product Linos 
'© Product Releases 
O Module Typos 

Seventy Levels 

Statuses 

Enclosure Types 


© User Group? 

<5 Grant Security Privileges 

•® Manage Connected Users 


© Change a Problem Assigned To 
d Change s Problem Version Open 
& Changs a Problem Module Owner 


® Data Dictionary 

4) Screen and Pepon Layouts 

0 Default Values & Behavior Settings 

§ Allowed Value Types 

<© System Wide Reports 

$ Siun on Message 


0 PiOd'JCtS 

Module Nantes 
© Priorities 
© Categories 
& Resolutions 
<d Manage Interest Lisis 


ExtraView Administration menu 


The following screen appears: 

i 


Installation Setup - Installation 



Database field name 

Value 

Description 

EH 
EES 

COMPANYJMAME 
C0MPANY_ADDRESS1 

Redback 

• 


COMPANY_ADDRE5S2 


• 






COMPANY_CITY 








COM PAN Y_STATE 

CA 

• 






COMPANY_ZIP 








UUMrANT_rnUNt 

(DJl) AbWlUU 





COMPANY_EMAIL 




WINDOW_BG_COLOR 

white 

Window background color 

.*•<&* 

BG_COLOR 

#EEEEEE 

Background color for tables 





BG_ALT_C010R 

#O9E0E4 

Alternative background color for tables 





ALT_COLOR 

white 

Alternate color for add, edit and search screens 




&st 

LABEl_COLOR 

royalblue 

Color of field labels on the screen 





Tm_E_COLOR 

scarlet 







DEFAULTFONT 

Anal, Helvetica, sans-serif 






MENU_0IRECTION 

VERTICAL 

The main menu can be HORIZONTAL or VERTICAL 






SESSION EXPIRE TIME HOURS 

24 

Max session idle time before user is forced to re-loqin 


Installation Setup screen 

2. Clicking the Edit icon next to an item allows you to make changes to the 
default settings. For example, this is the screen for editing 
WINDOW_BG_COLOR, which is the Window Background Color. 


Change entry in the installation details table 


Fixed database name WINDOW_BG_COLOR 

.Description ||Mndow background color 
Value (white 

: Update I . Cancel; I 


Editing Installation Details 

3. To edit this value or any of the others in this section just change the 
Description and or Value and click the Update button. 

4. Below is a complete list of Installation Setup Database Field Names, 
sample values and their appropriate descriptions; they can be altered in 
the Installation & Setup option. 


Application Default Name Typical Value Description 

COMPANY_NAME Your Company Name Company Name 

COMPANY ADDRESS1 269 Mt Hermon Rd Address 1 


C0MPANY_ADDRESS2 

COMPANY_CITY 

COMPANY_STATE 

COMPANY_ZIP 

COMPANY_PHONE 

COMPANY_EMAIL 

WINDOW_BG_COLOR 

BG COLOR 


Scotts Valley 

CA 

95066 

(831)461-7100 

support@sesame.com 

White 

Gainsboro 


Address 2 

Company City 

State 

Zip Code 

Phone Number 

Email Address 

Window background color 

Background color for tables 

Alternative background color for 

tables 

Alternate color for add, edit and 

search screens 

Color of field labels on the 

screen 

Color for titles on the screen 
Default font for text in the 
system 

The main menu can be 
HORIZONTAL or VERTICAL 
Max session idle time before 
user is forced to re-login. 
The URL for your ExtraView 
site. 


BG ALT COLOR 


Lightsteelblue 


ALT COLOR 


White 


LABEL COLOR 


#0000FF 


TITLE COLOR 


Scarlet 


DEFAULT FONT 


Arial, Helvetica, Sans-serif 


MENU DIRECTION 


VERTICAL 


SESSION EXPIRE TIME HOURS 24 


SITE URL 


http://www.extraview.net 


Data Dictionary 

The data dictionary is the central place where all field definitions are stored and 
maintained. In addition, this core component of ExtraView controls many of the 
attributes of each field, such as: 

• . display type. 

• display title. 

• whether the field is selectable on reports. 

• the SQL used to populate the field if it's a list. 

• default values. 

• help text and more. 


Edit Data Dictionary Items 


1 . From the Administration menu, click on Data Dictionary. 


Installation & Setup 

• Installation Setup 
® User Defined Fields 




The following screen appears: 


Data Dictionary 


Add a new field to the database 


Fixed name 
ACTIVE 

ALTJD 

AREA 

ASSIGNEDJTO 
ASSIGNED JTOJSIAME 
ATTACHMENT 


Screen title Type Help Tip 

Active - ; • Database Whether the item is active' 

Alt ID Database This is the alternative ID for a problem 

Area Database 

Assigned To Database The name of the user that this problem is currently assigned to. 

Owner Database 

Attachments Database The file or files that you are able to attach to a problem. 


Created 

Last 


updated 

system 

system 

28-MAY- 

21-DEC-2000 

2000 11:20 

2234 

system 

system 

2B-JUN-2000 07-MAR-2O01 

14:13 

14:55 

system 

system 

ZD-MAY- 

29-JUN-2000 

2000 11 28 

15:18 

system 

flo 

26- MAY- 

20-JUN-2001 

2000 11:28 

11:20 

system 

flo 

30- NOV- 

12-JUN-2001 

2000 10:50 

08:46 

system 

system 

0&.JUL-2000 10-DEC-2000 

18:37 

1155 


Data Dictionary Summary Screen 


4. Click the Edit button next to the item that you want to modify and then 
press Update to save the changes. 

5. You can include or alter many different features from this screen; see the 
screenshots below, with their corresponding roman numerals. 
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Change a database dictionary entry 


Fue«i iW*hA*e r*t>* ASSIGNEDJTO 

TiU* to display 


i !!=>» to «iV|>wy 

R*5u"«?e'i fide C Yel ?T 


•<»qti«e<i iic-fc r- Yes 
Deploy Typo <?Te>OTl£LD C 

r number r date 



<"* L<\be! r value 


.OGAREA PRiNTTE>TT LABEL <~ UST *** TAB 


URL |>SO.ASSSse...secumY..u» BrshowUagtD «9il»»p >d=t$NAME» 


y|| LjWw v-«iOTiton oil reponv <? Yes r No y| 
| — 1/ S*!* Ijss value r fos No ' 



V j 


C Yes No 


oyam:cali; to ust 
En:*bliV invest Ik* pmhs? fietc r Yes ^ No 


Default mntrt f 



III 



BQ 


select security jjserjd. itfirntftrstj^rrij-A^J |\/ 
sscur!ty_uoef ' 


3 



Vol Fdf«ni SvL 


Second i^ron; R5H Nsr^ f 


aa 
aa 


XII 



fne name ot" ths use! that this, piobtem is cufrently ^o«r tgn*jd 
to. Vj 



XI 


Edit Data Dictionary Item Screen 


I. The Screen Title for any field in your Extra View system. Just type a title in the 
given field and update. The field name will instantly be changed throughout 
ExtraView. 


II. The Data Type. Once set, these should not be altered. Changing these may 
have disastrous consequences on the use of ExtraView. 

a. DATABASE. These are ExtraView's inbuilt database fields. Their type 
must never be changed. 

b. UDF. These are the User Defined Fields in your system. 

c. SCREEN. These are the names of the screens within the ExtraView 
system. 

d. LABEL. These are fields created purely as informational labels on 
screens, and for which no value is stored. 

. Required Field. You have the ability to set a field as required or not. 


IV. The Display Type. This can be changed into any one of the following: 


a. TEXTFIELD. This is a normal, one line text field. Data may be up to 255 
characters in a TEXTFIELD. 

b. TEXTAREA. This is a larger, multi-line text field; it is expandable and 
collapsible and can hold up to 32k of text. 

c. LOGAREA. Similar to a TEXTAREA but previous entries to the field 
cannot be edited. You will see the User ID of the person who updated the 
field and the time and date when it was updated. It thus functions as a 
log of successive entries to the field. 

d. PRINTTEXT. This is also similar to the TEXTAREA field, but on display, 
a fixed-width font is used for the field. This can be used if the field may 

routinely be used to hold diagrams drawn with characters such as + + 

on the keyboard and you want to preserve the accuracy of the diagram. 

e. LABEL. A simple form label. 

f. LIST. A list of values; you can add or delete list items from the 
Configuration screen or from the User Defined Fields section. 

g. TAB. A list of values that is displayed as a set of tabs across the screen. 
Typically this is used to provide a high-level selection on a screen, where 
the subsequent fields depend on the tab selected. You should not use 
this display type if the supporting list has more than six entries. 

h. NUMBER. A field that accepts and stores only numbers. 

i. DATE. This is a field that allows dates to be entered and stored. 

V. The ability for a field to be associated with a URL. 

a. From the Data Dictionary click the Display as URL radio button to YES 


C NUMBER C DATE 

•Display as URL Yes *~ No 

^URL)$OASWse_security_user.showUseiOetails?p _userJd=WNAMEW| 

b. Type the appropriate URL in the URL field below the Display as URL 
button 

c. The URL can be anything you like, as long as it ends with 
?p=$$VALUE$$. This will take the value that is in the field and attach it 
to the appropriate URL. 

Examples: 

i. http://search.yahoo.com/search?p=$$VALUE$$ - After pressing the 
URL button Yahoo search results will be returned for the value 
that is in the particular field. 
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ii. $$OAS$$se_security_user.showUserDetails?p_user_id=$$VA 
LUE$$ - This example will display a particular user's details. By 
pressing the URL button a screen will be returned showing 
information on the user, from the ExtraView Database. 

VI. Allow Selection on Reports. This will enable the particular field to be available on 
Additional Reports. 

VII. Save Last Value. This will allow the user to save the previous value in the list 
when adding, editing or deleting. 

VIII. Enable Interest List. By choosing YES you are able to go into the configuration 
for this particular field and create an Interest List based on a particular value. 

IX. Default Value. From here you have the ability to enter a default value for a 
particular field. This value will have to be the actual database name as opposed 
to the title and will be automatically selected each time you add a problem to the 
database. 

X. SQL Statements. This shows the SQL statement used to populate the particular 
list. These fields also give you the option of inputting Parent Field Names and 
Parent SQL as well as Child Field Names and Child SQL in order to create 
dependencies. 

XI. Help Text (tool tip). When you mouse over a field, this is the message that will 
appear. 

XII. Help URL. You can link this to a field or page in your online help system. If you 
are an ExtraView hosted customer, note that this URL need not be on Sesame's 
server. You can store and access these files stored anywhere and accessible 
over the Internet. 


User Defined Fields (UDFs) 

A User Defined Field is a field that is setup specifically for your ExtraView 
installation and does not exist in the basic product. Since users may want to 
further customize their own site to include fields that are more specific and 
appropriate to their needs, UDFs are available to satisfy this requirement: 
This is a highly efficient and extensible mechanism. There is no limit to the 
number of UDFs that may be created. 

1 . User Defined Fields are found under the Installation & Setup sub-heading 
on the Administration menu. 
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Installation & Setup 

® Installation Setup 


User Defined Fields! 


Screen and Report Layout Types 
Saved Values 
Usage Statistics 
User Reports 
ExtraView License 


Data Dictionary 

Screen and Report Layouts 

Default Values. & Behavior Settings 

Allowed Value Types 

System Wide Reports 

Sign on Message 


Installation & Setup section 


2. Click on User Defined Fields. The following screen appears: 


User Defined Fields 


A 


Add 3 new entry k< the User Defined Fields table 


Fixed Name 

COMMENTS 

®MPON£NT 
CUSTOMER 
TEST CASE ID 

$M : ~ ■ y ~Mi 

DESCRIPTION 


Screen m« SjyS.^ 


Comments 


'LOG AREA 


'Component LIST 


Customer 


Lis 


: . .'III?::-'' 


URL 


t0:24 

. fff\" !8 ^!;A;;.,:.;„ 
2t-t<EC-?OC0 



Description 


TEXTAREA 


OS *- * 



PLATFORM 
RELEaS E _NOf E 3 ' 

ill! 

CLARIFY !0 


LIST, 


Platforms LIST 


Release- Notes ■ 7EXTAREA 


Serial-* 


10:^ 


• -till 

■ ■ Oft-JUL-ZOOp 



iilliililiiiili^ 


TEXT FIELD 


T^CpEllI©^fe^ C^ e rcaitcr, T E.-TflELP it enl », a Test C ,s* .at ,r^n, ,»S1 


■ -yi.y. 



07-SEP-2000 
16:40 


WORKAROUND 


A/'drkarounci 


FE.HTAREA' j 


'" - 00:00 

yyyy<yy^-y.v'y^ y-yyyy+yyyyyy yy -yy-yy. y.y.yyyyy.Y.vyy- 


Z1.PEC2000 
10:24 


11 reconjs selected 


Add User-Defined Fields screen 


To add a new UDF, click on the Add icon: 


Acta entry to we User Defined Fields table 


Name f 
Title [ 
0?ts labia nam* j 


Data Typo TEXTFIELD <"* TEXTAREA C LOG ARE A C NUMBER C DATE C LIST <~ TAB C URL 

P»>aulr^d tk-id C Yes <• No 

Display a* URL r Yes *? No 

URL | 

Alio?/ sslschon on reports r Yes 6 No 

Ajli?w rifffr Britnes io be added dy^miMliy to li« 0 Yes ^ No 

Help te»l 1 T] 

-■ 

Help URL | 

Update ; I ; Cancel I 


Add a A/ew UDF 

3. Enter a Name (which will become the database name), Title (which will 
appear on the screens), and select a Data Type. The remaining items 
are optional, however you may want set Allow Selection on Reports to 
"Yes" to ensure the new UDF will appear in the various ExtraView reports. 
Any item that appears in bold on the screen is not optional, and is needed 
to continue any further within the site. Click Update when finished. 

It is very important to note that UDF's can be created in the manner described above, 
but are not yet available to users on their screens. To achieve this, two further steps 
must be taken. After creating the UDF you must place the field on a layout at the 
appropriate place and you must then make the fields visible to the appropriate user 
groups, via the Grant Security Privileges screen. 


• 
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Name 

complete_date 

Title 

Project Completion Date 

Delta table narne 



Column name in table 


Data Type 
Required field 
Display as UPL 



otextfield ctextarea ^logarea c number <*date C list ctab <~url 

C Yes No 
^ Yes No 

URL 


Allow selection on report 1 
. Allow new entiles to be added dyamltafiy to list 



<r!Yes C No 
C Yes No 

Help test 


rtelp URL 

1 ... 


Update : | Cancel ;] 




Creating a A/ew (VDF 

Editing an Existing User-Defined Field 

To edit an existing UDF: 

1 . Click the Edit icon next to the UDF you wish to change, which brings up 
the following screen: 


Change an entry in the User Defined Fields tabfe 


OF Naw? CUSTOMER 

Si 

■Minn Ti;if ; (Customer 


N%iyip |PR08LEM_UDF 


.''Ms Typo LIST 

lsirt«jfisW r Yes ^ No 

iyjt»URL C Yes * No 

Ail*** ««iil*j?;lir;r: 

URl. 

'.if: f*5pl';.1a 

... 

C Yes No 
*" Yes «" No 



d 



..Update | Delete | ; Cancel;] 





£cf/f an existing UDF 

16 


2. Make the desired changes, and then click the Update button. 


Note: You cannot change the UDF data type from this screen. This can only 
be done in the Data Dictionary. See Screen shot below. 


UDF Name CUSTOMER 
Sc!8??r» title (Customer 

Data Table Name jPROBLEM.UDF 

Column N^me in Table f* 

DMa Type LIST <C 
Required field C Yes No 
Di^pidy as URL c Yes & No 
UP! I 

f* ♦ 

Allow selection on leports j^jYes C No 


Edit UDF Screen 

ExtraView Layout Editor 

The Layout Editor allows you to create your own customized screens in 
ExtraView. You are able to add fields for specific user groups or you can add 
fields on a default basis and control user access through Grant Security 
Privileges. 


Adding Layouts 

1 . The first step is to define the screen layout types you will be using. These 
are limited to the Add, Edit, Release and Search screens, however all 
ExtraView reports will soon be integrated into the Layout Editor. From the 
ExtraView Administration screen, select Screen and Report Layout 
Types, in the Installation & Setup section. 


Installation & Setup 


® Installation Setup 

# Data Dictionary 

• User Defined Fields 

© Screen and Report Layout Editor 

■ @ Screen and Report Layout Typed 

® Default Values & Behavior Settings 

® Saved Values 

# Allowed Value Types 

© Usage Statistics 

© System Wide Reports 

© User Reports 

® Sign on Message 

© ExtraView License 



ExtraView Administration Screen 
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2. Click on the Add icon to add a new layout type. 

LAYOUT TYPES 

AM a new Layout Type to the database 
r/f/e 

f 

Edit Problem Screen 
Report • Quicklist 
Add Problem Screen 
Report - Detailed 
Release Record , 
Search - .Query Screen 
Report:- Summary 
Module Record 

Screen and Report Layout Types 

3. Enter the fixed database name and an appropriate screen title to display. 
The fixed database names are: ADD_PROBLEM, EDIT_PROBLEM, 
RELEASE, SEARCH, QUICKLIST, DETAILED_REPORT, 
SUMMARY_REPORT, and MODULE. 


4. Click the Update button when finished. 


Add a new Layout Type to the database 

Fixed Database Name || 


Title to Display | 


: Update': 

Cancel ■ 



Adding a new Layout 


Editing an existing layout type is accomplished in a similar manner. 

1 . Click the Edit icon next to the layout type you wish to change. 

2. You can now delete the layout by pressing the Delete button, or change 
the screen title to display. You cannot change the fixed database name. 
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3. When you are finished, press the Update button. 


Change Layout Type details 


Fixed Database He 


MT\e ADD PROBLEM 


* Display (Add Problem Screen 



date i Delete ; ; Cancel 


Editing an existing Layout 

Editing Screen Layouts 

Once you have created the layout, return to the ExtraView Administration screen, and 
select Screen and Report Layout Editor from the Installation & Setup section. 

Installation & Setup 


ExtraView Administration screen 


1 . If you would like to create ExtraView screens for specific user groups, 
then you can select the Security Group to which the layout will apply from 
the dropdown list at the top. Additionally, you can use the default layout 
and control User Group screen and field access via the Grant Security 
Privileges section of the ExtraView Administration screen. 


@ Installation Setup 

© User Defined Fields 

@ Screen and Report Layout Types 

© Saved Values 

® Usage Statistics 

# User Reports 

© ExtraView License 



Allowed Value Types 
System Wide Reports 
Sign on Message 
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Layouts 

Select the security user group io which the layout belongs. If no layout is specified for a user group, the default layout will apply. 


Select Security Group * Default Layout for Ail Security Croups *j* 



I* Default Layout for All Security Croups * 


Now c hoc se a new layo^ 

Customer 


Add « new layout fa? !h 


Manager 
Test 
Guest 
^Administrator 




Add Problem Screen .Add Screen 
Edit Prob lem Scree ri edit Screen"." .• 
Search ■ Query Screen Search Screen 


e edit button by an easting layout to alter that layout. 


8 retort!* selected 


Selecting a Security Group 

2. Select the layout type to customize. The names in this field are the 
screen titles you chose when creating the layouts. 


Layouts 


Select the security user group to which the layout belongs. If no layout is specified for a user group, the default layout will apply. 
Select Security Group. |* Default Layout for Ah Security Croups * j^] 

Mow choose a new layout io add to the above security group, or press the edit button by an existing layout to aitet that layout. 


Add a new lay out for the mike system \ * Select Layout Type to Add ? 

* Select La yout T yp e to Add * j 

Layout Type Descriptio 



Add Problem Screen 


Edit Problem Screen 
Module Record 
Release Record 
Report - Detailed 
Report - Quick list 
Report - Summary 
Search - Query Screen 


th selected 


iliiljilillllillllft 


Selecting a layout 


For this example, we have selected Add Problem, which gives the following 
screen: 

f 

Note: You will have to repeat steps 4 thru 8 for the Edit Screen and the 
Search Screen. 
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Scree/? and Report Layout Editor 


Uyoui Name- F : Uyoui Typs: ADD PROBLEM User Group: Dafcart 


Row |l jfj Catumn |l Field Mams |* Seied & field or iayou' trom this list 

Required Y«* f No £ ■ 


■ Update Cell Jr. Delete Cell ; : : : ; Save Layout i ; Clear Layout : . h : ; :.Qele!e Layout 


Add Problem Screen Layout 

The screen layout is based on a grid, so you will have to choose the 
appropriate columns and rows to designate where you want a particular field 
to be placed. In this example, we want to place the Title field 
(SHORTJDESCR is the database name) in the top left hand corner of the 
Add Problem screen. 


4. To do this, select the field name from the Field Name list (which displays 
all the fields available, sorted alphabetically by screen title). Ensure Row 
is set to 1 , and Column is set to 1 , this indicates that the field will appear 
in the first row and first column of the Add Problem form. 

The Rowspan option will allow a field to span several rows. 

The Colspan option will allow a field to span several columns. 

In this case we want the Title field to be a long field, so we have set the 
Colspan to 2. 


Screen and Report Layout EdrioT 


Layout Mama- (Add Screen 


Layoui Typs: ADD , PROBLEM User Group: Omm\x 


Row |1 zi Column lTT| Field Name lT i ^.(SHORT„.DESCR} 
Rowspan |l 31 Colspan |T"1 



JV _ ., _ „. 

Liji^^£S I I /P^^'^lvl : SayeL^yout;; \ \ ClearLeyout ■ | \.\\ Deleie Layout 


Building the Add Screen 


5. Click the Update Cell button when finished 
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6. After updating the cell, you will see a screen that shows the layout of the 
Add Screen so far. 

Screen and Report Layout Editor 

Layout Name: |A.dd Problem j Layoul Type: AOD m PR03L£ : M U*er Group: Guest 





no 


Col 1 

Col 2 

saisa row i 





< 


■ ; Row IDH' -fcblumn |l FJ Field NSmef | Title (SHORTAGE SCR) fj 

j- : Upd#eCell. I K Delets Cell ; |l ' ;Seve .Layout | : : : Cie^ Layout;^] ;^ ■ Delete Layout -"J 


Add Screen Layout 


7. Continue adding fields to the Add Screen layout in the same manner. 

• Fields such as Description and Comments and any other "text area" 
fields are automatically set to span several rows, and can be 
dynamically increased or decreased on the actual screen that is 
created. This being the case, leave the Rowspan set to 1 . 

• The fields that have been designated as "Required" appear in bold. 

When you have finished adding fields and you have saved all of your 
changes click the Return button at the bottom of the screen to return to the 
main Layouts page. 

You can design additional screen layouts for the Edit and Search screens by 
selecting Edit and Search from the dropdown list and following steps 4 to 8. 
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Layouts ■ . 

Select the security user group to which the layout belongs. If no Uyout is specified for a user group, the default layout will apply. 
Select Security Group | * Oe fault Layout for All Security Croups * rj 

Now choose a new layout to add lo the above security group, or press the edit button by an existing layout to alter that layout. 


Add a new layout tor the entire system 
Layout Type Oescriptio 


Select Layout Type to Add * 'r_ 


* Select Layout Type to Add 


lAdd Problem Screen 


Edit Problem Screen 
Module Record 
Release Record 
Report - Detailed 
Report - Quick list 
Report - Summary 
Search - Query Screen 


is selected 



Adding Layouts screen 

Creating Release and Module Layouts 

The Release and Module layout are special cases. These are not individual 
screens, but a screen layout embedded within another screen layout. 
Layouts can be designed that can be embedded within both the Add and Edit 
screens if desired. You should be aware that you should not create recursion 
by embedding a layout within itself. ExtraView will only allow layouts to be 
nested four levels deep to prevent this behavior. 

Since issues can be tracked with ExtraView at the release or module level as 
well as at the problem level, release and module data is grouped in a "release 
row" or "module row" below the main problem data and above the long text 
areas, such as Description. After the single-row release or module layout is 
created, these fields will appear on the Add and Edit screens according to 
how the permissions are set in Grant Security Privileges.) This is discussed 
in detail in the next section. 

For this example, we will use the Release Layout. 

If you are planning on having fields with Release Information just do the 
following: 

1 . Click on Layout Editor from the Administration menu. 

■ • 

2. Select Release Record from the dropdown list. 
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i 


Layouts 


elecl the security user group lo which the layout belongs. If no layoul is specified for a user group. Ihe default layout will apply. 


Seleci Security Group [* Default Layout for Al! Security Croups * 

Now choose a n^w layout to add lo the above security group, or press Ihe edit button by an existing layout lo alter {hat layout. 


Add a ne« layout tot ths entire system 
Layout Type Desctiptio 


* Select Layout Type xo Add * 1 r 


w Select Layout Type to Add 


Add Problem Screen 


Edit Problem Screen 
Module Record 
Release Record 
Report - Detailed 
Report - Qui delist 
Report - Summary 
Search - Query Screen 


ds selected 



Add Release Layouts 

3. Add the fields that are appropriate to your install. These may include 
such things as: 

a. RELEASE_FOUND 

b. RELEASE_FIXED ; 

c. RE LEAS E_ASS I G N E D_TO 

d. RELEASE_RESOLUTION 

4. Save your current Layout by clicking the Save Layout button. 


To Add the Release Layout to Appropriate Screens: 

1 . Click Administration and then Layout Editor. 


2. For both the Add and Edit screen select LAYOUT. RELEASE from the 
dropdown list. . 

3. Choose the particular row that you want to add the release information to 
by selecting the row from the Row dropdown or by clicking the Insert 
button to insert a new row. 


4. Save your changes and view your results. 


Editing 


1 . If you want to edit a particular cell, simply click on the field you want to 
edit. 

2. You now have the ability to change the Rowspan, Colspan, Form 
Location or you can change the existing field with a completely different 
field. 
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3. Click the Update Cell button. Make sure you click Save Layout after 
each of your changes; otherwise changes will be lost when you leave this 
page. 


Screen and Report Layout Editor 



Layout Noi;r<t. |Ada Pt oblem 


Uyoul Typv. AD0..PR03LEM User Grosjp: Gu**t 


Row 2 


Row 3 


Row 4 


Row 5 


i MM Row 6 


Row 7 


Con 


Col 2 


SHOm_|)l;SCR 


PROPUCr_NAMIj 


PpiQPlTY 


CATEGORY 


^.VPPiTY,^L 


privacy 


Col 3 


Q£S£RJPJ±Q.N 


R**|? LrJ. Ookfrnr* |l rltld Hwz \ Comment (CX)MMENTS) 


"3 


Add Screen Layout 


Fields 


To delete a field: 


1 . Click on the particular field you want to delete. 

2. Click the Delete Cell button. 

3. Click Save Layout. 


Clearing Layouts 


To clear a layout: 


1. Press the Clear Layout button 


2. Press Save Layout 
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Deleting Layouts 

To delete a layout: 

1 . Press the Delete Layout button. 

2. Press Save Layout. 

* * 

Allowed Value Types 

Allowed Values serve two purposes for in your installation of ExtraView. It 
gives you the opportunity to sort your field lists in a non-natural sort way. For 
example, if you have a list of statuses as follows, they may be sorted as 
shown: 

Natural Sort Order 

Closed 
Fixed 
Open 
Submitted 


Allowed Value Lists also gives you the opportunity to have certain lists 
dependent on individual values in other lists; for example, a list of specific 
Platforms may only be displayed if the connected parent Product is first 
selected. 

1 . From the Administration menu, click Allowed Values under the 
Installation & Setup sub-section. 



Sorting with an Allowed Value List 

Submitted 
Open 
Fixed 
Closed 
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The following screen appears: 


Affowed Value Types 





mam 

mm 



Mm 




mm\\ 




mm 

mm 



m*m\ 

\mm 



mmm 



mm\ 

mm 


mm 

mm 


imm 

mm 


imm 



mm 

mm 


m»m 

mm 


mmm 

mm 


mm 

mm 


mm\ 

im 



mm 


Add a new allowed value type to the database 

Title Parent DB Name Child OB Name 


Category 
Disposition 
Product 
Status 

longallowedvaluestitlelong 

module 

parent 

parent 2 

platform 

severity 

Module Component 
Product Platform 
module child 
parent child 1 
parentchild2 • : " 
parent2 parent 
product parent2 '■ ». 


Module 

Product 

Module 

parent 

parent i!; 

parent? 

Product: 


Category 

Disposition 

Product ' 

Status 

Attachments 

Module 

parent 

parent? 

Platforms 

Severity 

A Component 

Platforms 

child 

child 

:Chi!d2 

parent 

par ent2 


17 records selected 



Allowed Value Types screen 

2. To create a new Allowed Value Type, click the Add icon. 


Allowed Value Types 


> 


Add a new allowed value type to the database 


Adding a New Allowed Value Type 
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The following screen appears: 

mo a new Mowed vawe /ype to the database 


V. 


None 


AComponent(COMPONENT) 


Update ; : .Cancel 


Add a new Allowed Value Type 

3. The Title is whatever you wish to name your Allowed Value Type. If you 
wish to set up dependencies, select a Parent Database Name and a Child 
Database Name to establish an appropriate relationship. 

4. Click Update when finished. 

Alternatively, if you just want to specify the order in which elements in a 
list box appear see step below only select it as a Child value and click 
Update. Skip to Step 12 for more detailed instructions. 


I HHP 


None 


A Component (COMPONENT) 


: : Update; : | ' Cancel ;i| 


Adding a new Allowed Value Type 

5. If you want to create a parent-child dependency between Category and 
Priority (using a sample Title of "Test), do so as seen below: 


Title [Test 


Parent daiabm* nam* |category(CATEGORY) 


Child database name | Priori ty(PRioRiTY) 


; : Update Cancel; 


Sample New Allowed Value Type 


6. Click the Update button 
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The following screen appears: 


Mowed Value Types 


wmwm 


Edit 



urn 


mm 


mmm 


mmm 


mm 


Add a new allowed value type to the database ■ 

Title Parent DB Name Child DB Name 

Disposition 
Product . 
Status 

lorKjailowedvaiuesmielong 
module 
patent 
parent 2 
platform 
seventy 

Module Component 
Product Platform 
Tesl 

module child 
parent child 1 
parent chi!d2 
parent2 paiem 
product paiem2 


1 ' ' '. 

. Category 


Disposition 


, Product 


Status 


Attachments 


Module 


parent 


parent.2 


Platforms • 


Severity 

Module 

A Component 

Product 

Platforms 

Category 

Priority ■ 

Module 

child 

parent 

child 

parent 

child2 

paren12 

parent 

Product 

parenl2 


IS records select e 



Sample Allowed Value Type 


7. Now that you have the dependency established, you can specify the 
details, i.e. what Priority will appear in a list box based on a selected 
Category. To do this, click the List icon next to the applicable Allowed 
Value Title. On the following screen click the Add icon. 


Allowed Value List for - Test 



Add a new entry to the list 
Category Priority Sort Sequence Owner 


Allowed Value List 

8. Select an item from the Category (Parent) list, and an item from the 
Priority (Child) list. If you wish, you can control the order in which items 
appear in the list box by entering an integer value in the Sort Sequence 
text box. 


9. Click Update and repeat steps 10 and 1 1 for each Child value you want 
to appear for each Parent item. 


Add entry to the User Defined Field list for Test 


CATEGORY | Enhancement^] 

PRIORITY |0 i| 


Owner J* None * 

/Update I : Cancel: 


Adding to the Allowed Value List 

10. If you want to set up a sort sequence for a field, for example: if you want 
to specify the order in which the items in Status appear, then follow steps 
1 , 2, and 3 as above. Once you reach the Add a New Allowed Value Type 
screen, specify a Title and the Child Database Name that correspond to 
the field you are setting the sort sequence. (For this example, Status). 


Adda new Allowed Value Type to the database 


Title Status Order 


Patm database name 
Child database name 

* None * 

Status(STATUS) * 

Severity(RELEASE_SEVERITY) * 

S e veri ty (S EVER! TY _ LEV EL) 

Sort By(SORT) 

Sort Order(REPORT.NAME) 

State Change Rules(STATUS.CHANCE) 

Status(RELEASE_STATUS) 

iStatusfSTATUS) ■ 

System Object AccessfcECURITY .PERMISSION) 

System Security Object Sum mary(SECURITY_ KEYS) — 

Test Case IDCTE5T.CASEJD) 

Test Case LocationfjEST JZASE.LOCATION) 

ii rare rroww: 

Copvriflht @ Sesame Technoloav. 1999- 2001. « 


Uc«ns«d to Sesame Technology 
DEV environment- version 3.1.2.1 DEV 

Report problems and request enhancements at the ExtraViewsupportsite . 


Adding a Sort Sequence to Status 

1 1 . After clicking on Update, you are returned to the Allowed Value Types 
screen. Click the List icon next to the Allowed Value title you want the 
sort sequence set on, in this case Status Order. 
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Allowed Value Types 


Add a new allowed value type to the database 

Title Parent 08 Name Child DB Name 



mmmm 


wmtwm 


.:■:>■:>:>■::•::■:: 


sassssgysa MHCSI 


mmmm 


mmmim 


mm 


mumi 


Edit 


Edit 


mm 


mi] 


mm 


Mm 


mm 


Category 
Disposition 
Product 
Status 

Status Order 

longallowedvaluestitlelong 

module 

module 

parent 

parent 2 

platform 

severity 

Module Component 
Product Platform 
module child 
parent childl 
parent child2 
parent2 parent 
product parent2 


Module 

Product 

Module 

parent 

parent 

parent2 

Product 


Category 
Disposition 
Product 
Status 
Status 
Attachments 
Module 
Module 
parent 
parent2 
Platforms 
Severity 
A Component 
Platforms 
child 
child 
child2 
parent- 
pare nt2 


Allowed Value Types screen 

12. Click the Add icon on the following screen: 


Allowed Value List for - Status Order 


> 


Add a new entry to the list 
Status Sort Sequence Owner 


Editing Allowed Value List 
13. Select an item from the Status dropdown menu. 


Add entry to the User Defined Field list for Status Order 






Closed 

V 


Sort SwqueriCw 

Closed 




Fixed 



Owner 



Pending 




Unassigned 



• Update;; 

Cancel | 


Selecting the First Sort Item 
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14. Specify an integer value in the Sort Sequence text box. 


Add entry to the User Defined Field list for Status Order 



:"ioit Sequence fT* 

Owner | ft None* 


Update Cancel 


Setting the Sort Sequence 

15. Click Update, and repeat these three steps until completed 

16. Click Return. 


Allowed Value List for- Status Order 


Hi 


Add a new entry to ths list 

Stains Sort SequeMce Owner 

Open 1 
Ltoassigned 2 
Fixed. 3 '.: 
Pending 4 
Closed 5 


V 


5 records selected 



Completed Sort Sequence List 


User and System Wide Reports 

These custom reports are generated through the Administration screen or from 
the Additional reports option on the Search screen. System Wide Reports are 
reports constructed by an ExtraView Administrator and are available to all of the 
Extra View users, while User Reports are created by individual users, for personal 
queries. 
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Change a report 


HvimtX rjame ROBBIE. LLOVO. STATUS 
Report title [sSnlsi 


| Status (STATUS) 

2| |" Second Sort Key" .Jf| 

| * Third Sort Key* 

F] |- Fourth Soft Key* ^ 


j Update | S;D&fe$:][ r"C&i)cei v | 


Vou customize this report by addinc columns to a layout you create below. Add columns from the database in the order you want them to appear on the report. 


Add a new column to the report 

Column Name Column Heading Sequence U 

flSTt'l STATUS • ■ STATUS " 


Change a Report Screen 

4 • 

To create User or System Wide Reports do the following: 

1 . From the Search/Report screen click the Additional Reports 

button. 

2. From the Administration screen click either the User or System 
Wide Reports button. 

3. To View any of the existing reports just click the View button next to 
the report. 

4. To create your own report click the Add a new personal report 

button. 

5. Fill in Report Name and Report Title. When adding the report name 
do not add any special characters or spaces, this is only the 
database name so it will not be viewable, the report title can contain 

v spaces or special characters. 

6. Select the Sort Order keys for your report and press update. 

7. Next you must add columns to your report by pressing the Edit 
button next to the report you just created, proceed to add as many 
columns as you please. 


To view this report: 


1 . From the Search Report screen click Additional Reports and then click 
the View button next to the report you just created. 

Note: A system wide or user report without columns will not appear on 
your Additional Reports Page until you add columns. It will appear in 
the Sort Order drop down box so you are able to run Summary, 
Detailed, or Quick list reports on these sorts. 
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Sign On Message 


Many organizations use the Sign on Message screen as a bulletin board for their 
organization (system-wide messaging). You are able to use all the conventions of HTML 
to customize your own Sign on Message. 


Installation & Setup 

© Installation Setup 

© User Defined Fields 

© Screen and Report Layout Types 

© Saved Values 

© Usage Statistics : 

© User Reports 

© ExtraView License 


© Data Dictionary 
© Screen and Report Layouts 
© Default Values & Behavior Settings 
© Allowed Value Types 
© System Wide Reports 


M Sum on 'Message] 


To create your company's personalized Sign on Message: 

■ 

1. From the administration menu, under Installation and Setup, click on Sign 
on Message. 

The following screen appears: 


Sign on Message 


Edit the message below, and then press the update button to save your changes. You can include html statements in 
the text. 


<centerxfont si2e»5 caior« M #FF0Q00'><em><b>We)a3 roe to ExtraView</b> </6'"= 
face»"Anal Helvetica Sens-serif size»2 cotor«b!ack> flHHHHHHP 
<pxfont face^Arial. Helvetica Sans-serif s>2e«3 color* bl©ck> View Doc<o 
bret-/redbock/docv'e>.traviev^uickfeterenceQuid8,pdf tarqet»btank> Here</a > 


Update; j ■ "fiasev- 1 


Sign On Message screen 

2. You can modify the Sign on Message in any manner. This screen allows 
you to display HTML on the home screen at the top of the page. When 
you are finished press the Update button. 
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Below is an example of a Home screen with the Sign on Message: 


ExtraView Home 


Welcome to ExtraView 

View DOC Here 



Click on a viBw icon to sbb problems assigned to you or choose an option from the menu. Return here at any time using the Home 
button. 


Problems you own: 

SUiu? 
Unassigned 

Problems you originated: 
Unassigned 


View 


Gsunl 


RD PI 


P7 
1 


•3 


'0 


n ! 
r i 


Use this quick search for simple queries. For more complex searching use the Search/Report menu button. 


Statu?, |"Any" 


Piarii* | -Any" >J 


Other 
1 


Other 

1 

2 


Home Page screen 


Behavior Settings 


The following topics will help you control behavior within ExtraView in order to 
better suit your company. 


Default Values & Behavior Settings (Application Defaults) 

This screen gives you the option of editing existing Default Values & Behavior 
Settings. New values cannot be added from this screen; the specified user is 
only allowed to change the Value and the Description. 

1 . Default Values & Behavior Settings are found under the Installation & 
Setup sub-heading on the Administration menu. 


Installation & Setup 


© Installation Setup 

# Data Dictionary 

<§ User Defined Field? 

# Screen and Report Layouts 

$ Screen and Report Layout Types 


® Saved Values 

® Allowed Value Types 

# Usage Statistics 

® System Wide Reports 

® User Reports 

$ Sign on Message 

© Ext review License 



Installation & Setup Section 
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2. Clicking on Default Values & Behavior Settings brings up screen similar to 
the following: 


Installation Setup - Default Values <3 Behavior Settings 


Database Ueid name 


J- 

.:;' t '".<.;"C- 


'-'■':<<■'.?■'<:■? ■' '•' ' • ' .••>'-: : : : : : -:. 


Descnption 



DEFAULT_USER GROUP 

IGNORE.USER 

DEFAULT_STATUS 
DEFAULT CATEGORY 
DEF AULT_PRIVAC Y 


GUEST 


_GROUP GUEST • 


'•<• "■";••■< 


UNASSIGNED 

^SOFTWARE ? . - ^ 
PRIVATE 


,Th i siusor qroup d oesnVown and cannot be assigned 
.problems , 

Default Status if none visible 
: Defauftjcategory in the add problem screen 
Default privacy setting when adding problems 


Ill v ^CLOSED 


wfe :v ^ : * : V^y : : : : : y. ; :^: ; ;*: : :**i. : : ; *-:-.v- : 


S2H DEFAULT_TEXT_REPORT_DEUMfTER 


FILTER^ MODULE BY CATEGORY - NO « 
LINK MODULE OWNER ASSIGNED TO Yes 


ENFORCE STATE CHANGE RULES / YES / - 
ENABLE PRIVACY GROUPS YES 


-Namefc 

Single character to place between data fields 


... IN a me loft He c I o sed stat us of a problem 

•• 'i. -^i'i:- i : ' ■ ■ ' ' ' ^iSWiiiiS?: •' % < ' 



SEPARATE WORK FLOW 
ADMIN BYPASS GROUP 


i NONE.:. 
ADMIN 


/J i :;:: > : - -i: • 


^ u Allow filtering; of. modules by category (YES/NO) 
Link the module owner field to the assigned to field 


Enables Privacy Group based data security. 

'<: '^IfAllowisepaVateJwoVkffiows iper|USERGp0UP or 
PRODUCT or NONE - f ^ " ■ ■* 

Name of group with state change override privileges. 


. REPORTXOUNT^METHOD PROBLEM 
STATUS^TRACKI N G_M ETHOD PROBLEM 
ALLOW UNLIMITED SEARCH NO % ' 


UMIT^WORD_RECORDS 100 
UMIT_WORD_DETAlLEp_RECORDS 25 
ABRREVIATED_HOME_PAGE YES 
SORT PRODUCT 
SORT MODULE 


« W. ,f ' 


• y*. *v *«v:s- .a. a . 


SORT UDF 

:::-:.;.*:•* v .. ^ :..:>.v<-" *-..':":.: 

SORT SEVERITY 


^PROBLEM,. MODULE or RELEASE 
PROBLEM or RELEASE 

Allows unlimited' rows to be^retumedjoh queries 

Max number of records returned from a search to a MS 
Word report 

Max. : number;pf :d^ .. 

Display the searchable home page or the abbreviated 
version 


.w.v.v. .v.-.v • 


Default Values & Behavior Settings screen 

3. Clicking the Edit icon next to an item allows you to make changes to the 
default settings. For example, this is the screen for editing 
IGNORE_USER_GROUP: 

4. For each Application Default you want to edit just change the Description 
and or Value and press update. 


Change entry in the instaiiation details table 


R-rdda&bassnam* IGNORE USER GROUP 


Description (This user group doesn't own and cannot be assigned problems 
Value |GUEST 

Update j Cancel | 


Editing a Default Value 
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The following table includes all of the Application Defaults that are editable by the 
System Administrator, organized by Application Default Name, a sample Value and a 
Description. 


Application Default Value 

DEFAULTJJSER_GROUP GUEST 

IGNORE_USER_GROUP GUEST 

DEFAULT_STATUS UNASSIGNED 

DEFAULT_CATEGORY SOFTWARE 

DEFAULT_PRIVACY Private 

STATUS_CLOSED_NAME Closed 

DEFAULT J-EXTJREPORTJDELIMITER 

FILTER_MODULE_BY_CATEGORY NO 

LINK_MODULE_OWNER_ASSIGNED_TO YES 

ENFORCE_STATE_CHANGE_RULES NO 

ENABLE_PRIVACY_GROUPS YES 

SEPARATE_WORKFLOW USERGROUP 

ADMIN_BYPASS_GROUP ADMIN 

REPORT_COUNT_METHOD RELEASE 

STATUS_TRACKING_METHOD RELEASE 

ALLOW_UNLIMITED_SEARCH YES 

, LIMIT J/VORD_RECORDS 1 00 

LIMIT_WORD_DETAILED_RECORDS 25 

ABBREVIATED_HOME_PAGE YES 

USER_SELF_REGISTRATION NO 

ENFORCE_DETAILED_USER_INFO YES 

STRICT_PASSWORDS YES 

SESSION_EXPIRE_TIME_HOURS 24 

PASSWORD EXPIRE TIME DAYS 10 


Description 

User Group for User Self-Registration. 

This user group doesn't own and cannot be 

assigned problems 

Default Status if none visible 

Default category in the add problem screen 

Default privacy setting when adding 

problems 

This feature allows users to specify what 
their nomenclature for Closed is. This is vital 
for using the ALLOWED_EDIT_CLOSED 
feature. 

Single character to place between data 
fields 

If you would like your Modules to be based 
on particular Categories as well as Products 
set this value to YES. When you add 
Modules in the Configuration section, you 
will have the opportunity to associate the 
Module with a particular Category. 
Automatically populates Assigned to field 
with the appropriate Module Owner. 
Ability to turn these rules on or off. 
This turns n the functionality to utilize 
Privacy Groups (see the section on 
Security). 

This allows you to enforce State Change 
Rules based on PRODUCT, USERGROUPS 
or NONE. 

The Group to bypass State Change Rules. 
You can keep track of ExtraView issues by 
PROBLEM, MODULE or RELEASE 
You can keep track of the status of 
ExtraView issues by PROBLEM, MODULE 
or RELEASE 

Allows unlimited rows to be returned on 
queries 

The maximum number of MS Word Records 
that can be outputted for reporting purposes. 
The maximum number of MS Word detailed 
reports that can be returned. 
This indicates whether you have a standard 
home page (YES) or a Customized Home 
Page (NO). 

Allow users to register themselves from the 
sign on screen 

By being set to YES this makes nearly all of 
the fields on the User Registration screen 
required. 

Require passwords to be at least 6 chars 
with 1 non-alpha char. 
Idle time before a user is forced to sign back 
on to the system. 

Days before a user has to establish a new 
password. 
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SUPPORT LINK 


USER LIST SIZE 


support@sesame.com 


25 


EMAIL_NOTIFICATION 

EMAILJDIRECTORY 

EMAIL_FROM_USER_ID 
EMAIL_FROM_USER_NAME 

EMAIL_MODULE_OWNER_ALWAYS 
EMAIL SUBJECT TEMPLATE 


DEFAULT_USER_FOR_EMAIL 
OWNER. TYPE 


ASSIGNED TO.TYPE 


RELEASE FOUND.TYPE 


RELEASE FIXEDTYPE 


YES 

/o racl e/Extra Vi e w/m a i I box 

ExtraView.dev@sesame.com 
ExtraView 

Yes 

[$$ID$$] $$SHORT_DESC$$ 


SYSTEM 
TEXT 
TEXT 
TEXT 

r 

TEXT 


Simple HTML used to show the support link 

at the bottom of each page. 

This field holds the value for the number of 

users in a selection list before it is broken 

down and grouped by letter, user group or 

name. 

This applies to Pop Up text boxes and to the 
User Accounts screen. 
Turn on Email Notification of changes 
(YES/NO) ' 

Email Directory for outgoing messages to be 
stored 

Return address for all email 

Alias for the real user name that email 

originates from' 

Option to send email to the Module Owner. 
This allows users to customize their email 
subject line: The email section has detailed 
instructions on how to alter this. 
User to receive email when a problem is not 
assigned to anyone 

Allows the value to be accessible through a 

list or a pop up text box. 

Allows the value to be accessible through a 

list or a pop up text box. 

Allows the value to be accessible through a 

list or a pop up text box. 

Allows the value to be accessible through a 

list or a pop up text box. 


Some of the above Application Defaults that are commonly altered include: 

DEFAULT_STATUS - You can set this to any status that you have in 
your status list 

DEFAULT_CATEGORY - You can set this to any category that you have. 

DEFAULT_PRODUCP- You can set this to any product that you have. 

DEFAULT_PRIVACY - You can set this to either Private or Public. 

ENFORCE_STATE_CHANGE_RULES - Gives you the opportunity to 
turn State Change Rules on or off. 

USER_SELF_REGISTRATION - You can allow your users to self- 
register, or you can be the registrar. 

SUPPORTJJNK - If you have an HTML page that you would like your 
users to go to you can put the link here. 

EMAIL_FROM_USERJD - for example; ExfraWew@yourcompany.com 

EMAIL_SUBJECTTEMPLATE - This allows you to use fields within the 
record and place them within the subject line of the email that is 
generated. The field that you want to include is enclosed between $$ and 
$$. For example, the problem title is $$SHORT_DESCR$$. 

USERNAMEJDISPLAY - You have the ability to display usernames by 
First, Last or by ID based on your company's methodology. 
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Viewing Usage Statistics 

In order to efficiently conduct business, vital information must be recorded 
and analyzed with the intention of perfecting the development process. 
Usage Statistics can be accessed via the Administration menu, under the 
Installation & Setup heading. 

1 . Clicking on Usage Statistics brings up the following page: 


Usage Statistics 


Report prepared August 17,2001 11:08 

User Statistics 

! Number of users 
Number of active users 


■ i-..; ..Vf 


Number of active c ust o irierlusefs 


Number of internal users 
Number of active users inwoupAdrriihistrafor 

' . ',.,.•;:*•• *"* :,: *- *• ■:..** : * : :<^:A: : AA':v'. : 'A; : : : ^-: ! :-.>^ x :V:'. : . : rP: : . ; : V' X.'- - 

. . \. •• .:• :■ ■ WSS:?^ 

Number of active users in group Development Manager 
! Numb er of act ive users in g ro up Engineer 

• . / • • ••. •. : •' •' v <c. *.• .' 

Number of active users in group Guest 
. Number of active users \r\?$roup Management 

Number of active users in group Zephyr Contracting 
i Number of active users in group QA Engineers 

Number of active users in group QA Manager 

Number of active users in group fleiSefese^ 

Number of active users in group 7AC Engineer 
\ Number^bf activejusers in qrou^T^' Manager ^ " 

Number of active users in group Tech. Pubs. Manager 
; Number of active users in group Technical V^/riter 

Number of active users in group Testing 









' : , . :: ■.'.':': '.: >; 





t 


470 

■■ j 9 

:v' : : ^.y i 
- ':¥?<x':':yr : : 

461 

'"3B 

Ti 

441 
14 

8 
6 
5 

4 

■ |2ii 
2 


The page is divided into 3 main sections: User Statistics, Problem Statistics, and 
File Attachments. 
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User Statistics 


Number of users 

467 

Number of active users 


Number of active customer users 

11 

Number of internal users . 

: : 452 

... . i . .. .< 

Number of active users in group Administrator 

32 

Number of active users in group Development Manager 
Number of active users in group Engineer 

429 

, Number of active users in -group Guest 

;J ' 12 

Number of active users in group QA Engineer 

3 

Number of active users in group QA Manager 

" :; " - :3 

Numhpr nf artivp n<>prc in nrniin Pp/ps.sp /Wsnprcp/np/jf 

HUM IUCI Ul QLUVC U9vlv III Ul UUU nF/7aw mor /a u&l 1 1P1 M 

3 

w 

Number of active users in group TAC Engineer { 

.'V- \;3 

Number of active users in group TAC Manager 

2 

Number of active users in group Tech Pubs: Manager ' 


Number of active users in group Technical Writer 

" 2 


User Statistics section 


Problem Statistics 


Total number of problems in database 

384 

Number of problems : created to date this month 

•; ; ; 104 

Number of problems created last month (May) 

26 

Number of problems created. in last ;3(3 days 


Number of updates applied to date this month 

506 

Number of updates applied last month (May) :• .V 

150 

Number of updates applied in last 30 days 

624 


Problem Statistics section 


File Attachments 


Number of attachments in system 

48 

Average size of an attachment (kB) • 

;.?=?; ;557 

Maximum size of an attachment (kB) 

10199 


File Attachments section 


ExtraView Configuration 

Configuration items are fields other than UDFs that appear in your installation 
of ExtraView. The Configuration section of Administration menu will vary 


r 
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drastically based on different companies' particular implementations. 


Altering Configuration Settings 


1 . From the Administration menu, see the items under Configuration. 


Configuration 


# Product Lines 

# Products 

# Product Releases 

# Module Names 

# Module Types 

# Priorities 

® Severity Levels 

# Categories 

® Statuses 

# Resolutions 

Enclosure Types 

# Manage Interest Lists 


Configuration section 

2. For purposes of explanation, we will use Module Names as our example. 
Module Names is a setting that is dependent on other factors (parent- 
child relationships). For this reason the drop down format is used and the 
process is slightly different than entering things that are independent. 

3. To add or modify a Module, click Module Names. 
The following screen appears: 


Module Names 


3 Add a new entry to the Module table 


Product j* None * 

Module Name Modufe Titte Owner Module Type Create<i Last updated 


0 records selected 


Module Names screen 

> 

4. Click the Add icon to create a new Module Name. Since Module depends 
on Product, you will have to choose an applicable Product ixoxw the drop- 
down list to associate with your new Module. Fill in the appropriate fields 
and click the Update button. 
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Update 1 Cancel; 


Module interest List 


Adding a Module Name 


5. To modify an already existing Module Name, return to the Administration 
menu and select Module Name, as in step 4. Select the Product that 
pertains to the Module you want to edit. 


Module Names 


Add a new entry to Ihe Module tabU 


Product 


MetOp 


Dev Tools 
Empty product 
Global interaction 
Net Transactions 


NetO 


1ENT 


Edit, 


Practice 
'Robbie 
Smart Edge 
SMS 

]Tech Pub* 
Ted 


EMb 


PM 
PORT 
SECURITY 
SERVER 

SHELF CONTPGLEP PROTECTION Shelf Controls Protection 
TRANSACTION Transaction 


Module Title Owner 

Agent Environment ' ' . ■ rcoofc 
Client lufl 
S 

EMS Inventory 

JAM Main ; u : 

PM 
Port 

Security 

Server ■ lyft, 


Software 


Michelle Medina Hardware 


So?} ware 


1 1 records selectee 



Created 

updated 

£ h*t .: T; 


12AU0-1O30 27.APft.2001 



t0.t.PC- 190ft 12 « 1&DECM9dS t:56 



C2-j.w-2Qoo i5.se 02 ju* 2000 153a 



17.JUM.2000 1047 

t7<JU*2O00 10.47 


<Jjfit 


OS^UNCOOO 14;45 



05-JUL-2000 10:13 

07-MAR-20O1 17:0 f 



0?»JUN.20O0 '3:51 

07JUN2000 *3:S? 


(Urn 

10-, KM- 2000 i2:30 

1SJUN-2000 1250 




10DEC-I0&a 10:22. 



23-JUNC000 12:20 

2«.Jg?i2000 12:20 


fcatr,ie,h 

12UUL-2O0O 12.-4J 

12. JUL 2000 12:43 


Editing an Existing Module 


6. Click the Edit button next to the Module that you wish to change. 


Module Names 


Add a new £rttfy to the Module table 


Product jNetOp 



edit 


Module Name 

AGENT ENVIRONMENT 

CUE NT 

EMS 

EMS INVENTORY 

JAM MAIN 

PM 

PORT. 

SECURITY 

SERVER 


Module Title 

Agent Envirdhmenl 
Client 

EMS . : '■' !/. i 

EMS Iwentoiy 

JAM Main " 

PM 

Port • 

Security 

Server 


Owner 

? cook 

lUJt 


Module Type Created 


Software 


Michelle Medina Hardware 


Software 


SHELF CONTROLER PROTECTION Shelf Coniroler Protection 
TRANSACTION Transaction 


1 1 recoid* elected 



«SQ9 07:38 

Ct>J>3wifi 

,'02-JU^2000 15:59' 
17-JUN2000 18.47 

:<iaf»t ; ' 

05-JUI.-2000 10:13 
0?-JUfM'000 13;5I 
19-JUN-2000 123G 
lO-DEC-lOv*- 10:22 
25.JUN-2O00 i2.:29 

fritfttCh 

12-JUL-2G00 124? 


Last updated 

ct>#ld<*iin 

10 DEC i«aa i2.so 

02JUN-2OOO 15:£«. 

17-JUM.2000 19:47 
dint 

03-JUN-2OOO 14:43 
07-MAR-2001 17 01 
07.JUN-2000 0:6i 
16JUN.2O00 12:>0 
10.06CW33 10:22 
20-JUN-2000 i:i-2<» 
12- JUL- 2000 12:43 


Edit an Existing Module 

7. On the following screen, make the desired changes and click the Update 
button. 


Change an entry in the Module table 


I 


Product NetOp 
Module CLIENT 

Module Owner lluft ?\ 
Module Type | Software 
Title |ciient 



Update jj iQejete | : Gahcel : | V- '■" Module Interest List ■ . | 


Editing a Module 


8. Statuses are an example of simple independent lists. To add or modify an 
independent Configuration Setting, go to the Administration menu, and 
click the applicable field name in the Configuration section, in this case 
Statuses. 
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* 


Configuration 

® Products 

© Module Names 

® Priorities 

® Categories 

® Resolutions 

® Manage interest Lists 


® Product Releases 
® Module Types 


Severity Lev^ 


Statuses 



® Enclosure lyyus 
® System Configuration 


Configuration section 
The following Add a new field to the database screen appears: 


Statuses 


Add <i new field to the database 


Fixed name 

^CLOSED; . 
FIXED 
OPEN ■ 
PENDING 


Screen title Created 

Closed 


Lesf updated 


Fixed 
Opw ■■■ 
Pending 


10-C-6C- Mm 10:2i 29-AUG-2G00 13:01 

22. APfc'HW© 03:37 26- JUL-2000 13 5? 
r/st*n. ryritm 


UNASSiGNED Unaligned ^p. 18W »:is 2MP«-ai0i tt« 


5 tecords selected 


Statuses screen 

9. To add a new status,, click the Add icon, and 
name and desired display title. 

1 0. Click the Update button. 


in the fixed database 


Add a new fieid to the database 


* : \r&G database name 


no rq 


HicnlsiV 


Update j : Gahcel : j 


Adding a New Status 

1 1 . To edit an existing status, click the Edit icon next to the status name you 
wish to change. You can either change its screen title or delete it. Click 
the Update button when finished. 
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Change a Status's details 


Fi.«9d database nam* CLOSED 
Tide k> display on s>; rwns loosed 


Update | Deiete ; | ^C^rlcsi; | 


Editing an Existing Status 


User Roles 


You have the ability to change your role as long as you belong to more than 
one User Group. This allows you to wear a "different hat". By changing your 
role you can test the functionality of your implementation and clearly see the 
permissions of a particular User Group without having to login repeatedly. 


In order to change your user role without logging out, just click on click to 
change your current user role located near the bottom of the home page. 


■■■■ 
mMMSmmmmm 



t 


ExtraSAkw | 

on 
J * 

git 


Problems you originated: 
Statu? 
Missioned 


3 ■ 


PI 


P? 
1 


Other 


ihi$ quick search for simple queries. For more complex searching use the Search/Re port menu buMon. 
j S?£!y*; j " Any * jj 


As«j<ir<e<! io 


Pnorby |*Any* 


Ca?*;0Ofy j "Any* 
Mc«Juo I "Any" 


From Date* 


OtH« cis?sted 
Lssi Modified [ 


m r 

II r 


Son 


v 

L 


Priority 
^ Bug ID 
<~ Date Modified 


0 Click y?u? cutre^ r^[«f 4 

'O Click id edit your personal options. 
"O Click io edit your personal emait interest list 



f» Attending 
r Descending 
Records psr f : "ac.o " 


Search 


Home Page screen 

Select the role you would like to play by selecting a radio button from any 
User Group and then clicking the select button. Your role has now been 
changed and your permissions will reflect the change. You may find that 
access to certain buttons on the left navigation bar disappears, or that fields 
no longer show up in the add/edit screens, or that buttons are added and 
fields appear in some screens; this is a direct result of changing your role. 
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I 


Choose the role you wish to adopt 


Development Manager 
f Administrator <^ 
f Technical Writer \ 
' TAC Engineer 

Engineer 

Release Management 
: Select | 







User Role screen 


Customized ExtraView Home Screen 

Different installations may have different-customized Home Pages. The main 
feature of the Home Page shown is a Data Summary Table: 

• Provides a list of the user's currently active problems by product 

• Provides a list of the issues that the user created 

• Provides the status of all currently active problems by product 

• Provides the user a drill-down view of all currently active problems by 
product 

• Provides a count of all currently active problems by product 


/ . 
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ExtraView Home 


Welcome to Extra View 


View the complete online documentation (7 MS) lie?e 
To view the user guide click (1 .6MB) here 
View the release notes for version 3.1 here 


Click on a view icon to see problems assigned to you or choose an option from the menu. Return here at any time using the Home button. 


Sfatu> 


r-ij 


-Olht? 


Open 
i Pendinq 


v./kvAvrt i 


1 

31 


i 

2* 


Unassigned .6 1 

Use this quick search for simple queries. For more complex searching use the Search/Report menu button. 


Status |* Any* rj 

From Dale 


To Date 

Product |* Any * jjjj 

Date created f 



| Version Open j 

jT| last Modmed f~ 

1 


Owner 

l ? | Originator | 

El 


| Sort ay * P "°» l 1 

^ Ascending . 



<~ Bug ID 

f* Descending 


( Search J 

<** Date Modmed 

Records per Page 1 20 £| 





Click to edit your personal options. 


jpftl Click to edit your personal email interest list. 


Home Page screen 


In addition to the Data Summary Table, the top part of the Home Page has a 
message field that the system administrator can alter at any time. 

Perhaps the most innovative feature of the Home Page is the Quick Search 
option that is provided. Here you are able to use the majority of the search 
parameters provided on the Search/Report screen to begin searching. Also 
note that in Unix, the pick list is not scrollable but static. 

If you or your customers are not interested in searching from the Home 
Screen, you can turn this feature off. 

1 . From the Administration menu, click on Default Values and Behavior 
Settings and then click Edit next to ABBREVIATED_HOME_PAGE. 
From this screen you are able to enter "yes" or "no" based on your 
preference. 
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Unas&igned 


View 


V. 3 


PG 


PI 


P2 
.1 


Use this quick search for simple queries. For mow complex searching uio the Search/Report menu button. 



Status |*Any* ""]•] 


/tssigrwct ;0 

Product | "Any* |j| 


f:?- 


Pny/rty |«*ny- 3 


CstKpry I'* .Any 

Module |*Any 


From O&e 


* » 


Varstwn Open j 


Dots emitted f 
Last Mcdif-ed j" 


' ^ Bug ID 
^ Date Modified 


Ascending 

r Descending 
P«cdrds p&r P'a^e [20 J] 


Click to Changs your current user role. 
*® Click to edit your persona! options. 
# Click to edit your persona! email interest list. 


1 


TV; DM* 


Oiher 
■ 2 


7 



Home Page screen 

To use the search option from the home page: 


1 . Select anything in the fields above to build your query. For example, you 
can select one option or multiple options from status or from product or 
both. Then click on the Search button and the results are displayed. 


Quick List 


Hug # 

12521 
18jun99 

12:320 

7 

12519 
18jun99 ll 

1251 1 

I8jyn99 

12-190 
!8jUr>99 

12488 

1.9 

12488 

1.4.1 

12478. 

IFhir-QQ - 


fi*SM3T i U> 20 c» 3&<t 


Version ClastKl 

calendar . 

Test 

Tgflipg Time fanes 


Protiud 

Module 

Status 


SMS 

802; Iq 

Uns'ssigned 


Robbie 

4 

Closed 


sms ; "■ 

AAAb 

Closed • 


Robbie 

4 

Pending 


SMS 

AAAb 


Assigned lc 
cies • • 1 


cartel 


te?j refresh foffi<m 

add problem as a quest 
Ml ■ - 


Unaligned 
SMS AAAb 
Open 0 
, DevTeM Test Automation flp. 
Pending 0 Florence 

SMS 802. iq fi2 
Pending 0 florenc,? 

SMS 802. Iq {j££,,' 

Or.fr; Q_ Qa — '. 


Uftt Modified 
Days \n 0ii8«« ' 
2001-06-29 10:18 
0 

2001-06-2909:43 
0 

2001 -G6-29 09:24 
0 

2001-06-22 13:42 

D 

"2001-06-26 15:04 

■■ 8 
2001-06-27 12:57 
8 

2001-06-21 09:29 

, 8\ ' 
2001.06-21 09:40 
8 

2001436-21.09:42 

■ ' J2— 


Quick List 
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Editing Your Personal Options 


Editing personal options allows you control how you want to enter dates into 
the system, what your password will be, user information that others will see, 
notification via e-mail, how many records you view per page and what privacy 
group you belong to. 



Problems you originated 






Siatus Vi 


Count Hi f 




;■■ Unaligned £ 



1 ' 1 2 " 


Use ihis 

(jLiic.k fc&.vc.h for 6imp(e queries For more complex »erirchmg use the Seaich/Pspoh menu button 



Status |*Any* r\ 


?fiiy|*Any* rj 


i 
< 


A&sugn^d To ["""* j? | 
Pioduct |*Any*' r] 

0* 



! 


Causae |*An/* >J 


Ffljnt Date 

To Dare 

t 

| 

j 



Gate cjs 


i ill 


Version Open | ' j 

last Mod 


I il 

! 


So^i ****** 
r Bug ID 


Ascending 
Descending 

I; Search H| 

< 

< 
< 


r Date Modified Peccr* 

h pet Psrs 

e|20 *| 


© Click to Changs your curi&nt user rofe A 






to edit your per^onai onions.; ( 





O Clicfc 

• to edit your peitonal email interest^!. 






Home Page screen 


Prior to entering this screen you will be asked to enter your password. 


Enter your password 

tnUv password [ 

Enter] Cancel | ^ 

> 




Copvriaht* Scum* Ttchnoloav. 19QQ - 2001. All riahts r««(v«d. 

Lictnsidto Stumi Technology 

DEV environment- version 3.1.2.1 DEV 

Report oroblems ind reauest enhancements jttne ExtrjVlewjuoDortstte. 



Secondary Level Password screen 
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Change your personal details 


User ID ROBBIE. LLOYD 


FiisI name jRobbie 
Last name | Lloyd 
Password 


Verify Password p 


Update.; Cancel: 


Email address jrlloyd@sesame.com 
Email format 1HTML 9 
Dal? format |DD-MON-YYYY hh24:mi_^| 


Timezane |GMT-8 hours jD 

* 

Notify on own updates Yes C No 

1000 >J 


Kecoros pa? Wage 

Job litis f 
Company name 


Address {Sesame 


r 

Oily f 

State / Ptovmee [ 

Zip / Post Code f 

Counhy |" 

WoiU phone, f 

Home phane | 


Ceil phone 


Pager [" 


Change Personal Details screen 


MANAGE USERS & SECURITY 


ExtraView allows the System Administrator to create an unlimited number of 
user groups and users, and to define, and then apply security or access 
privileges to users based on these groups. These access privileges are 
applied to each and every field, to each and every menu button, and various 
other features within ExtraView, allowing you to control access to nearly 
every feature of the product. 


User Groups 


User Groups are the functional teams of your company or the external users 
that will be using ExtraView. User Groups are assigned specific privileges 
based on what you want each of them to be able to see and do. Sesame 
Technology will generally provide the initial User Groups setup for you at the 
time of license. These initial groups may or may not include the following:* 

• Administrator 

• Customer 

• Engineer 

• QA 


Add User Groups 


1 . Click User Groups under Users & Security on the Administration menu. 



IT* 


ExtraVievj Administration 


Users & Security 

Us*?? Accounts 
® System Security Keys 
Privacy Group? 

Batch Commands 

0 Change 9 Problem Own or 
<© Change a Problem Originator 


£53 <^ 

ecurity PrrWgeT 


-d Grant Security 
® Manage Connected Users 


© Chance a Problem Assigned To 
® Change a Problem Version Open 


Administration screen 


2. Click the Add button on the User Groups Summary screen. 


User Groups Summary 



Arid a new usfer group 



User Group Name 


■ QA.ENGINEER 


D£V_MAHAG£P 

MB 

"TECHPUBS . 

IS 

QA_MAMAGEF 


i . <*""■* • 


Title To Display On All Screens 

QA Engiri&er 
D*v&lopmsn: Manager 
VTedr pubs, Manager 


User Groups Summary screen 

3. Type in a database name, and make it relevant to the name you will use 
as a title (I). Valid Database names have no spaces, and are composed 
of letters, numbers, and the characters, and '+. 

4. Type in a title (II). 

5. You can then choose to clone the Security Privileges from another 
existing group, or set your own from Grant Security Privileges by first 
selecting the *create with no permissions* option (III). Cloning a group is 
particularly useful when you want to create a new group similar to an 
existing one. After cloning the privileges, you can make any changes to 
the new group from the Grant Security Privileges screen. 


r 


' O I * 9 > 


MM 



ua&m 




w 



Add a user group 



database tnma CEO 
Tills to display on screens |CEO 


— | * create **:ih no permissions 


PS 


create with no permissions * 
Administrator 
Development Manager 
Enaineer 


IGuest 


QA Engineer 

OA Manager 
Release Management 
TAC Engineer 
TAC Manager 
Tech. Pubs. Manager 


C->pyti»ht $ §> i*» m »7» cho ftt »fly. iSSG ■ 200 1 . o» tight? r»i*iv»d. 
Lk*nt*<3 to StSJms * schfiolo-jy 
<jj *n*uc>f>!T>*M • won 3.1.2 0 


Add a User Group screen 


Add New Users 


1 . Click User Accounts from the Administration menu. 
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ExtraVie*a Administration 


Users & Security 

$ Sysiem Secwily Keys 
S 'Privacy Groups 


P Usfef Groups 

® Grant Secuuty PrMk-oes 

$ Manaue Connected Us^rs 


Administration screen 


The User Accounts Summary screen appears. 

At the top of the User Accounts Summary screen there is the increased functionality to 
narrow the list of users returned. 

• To return inactive users, all users or users belonging to a particular user 
groups select the appropriate option from the Select users to display 
dropdown 

• To return all users with a User ID beginning with a particular letter just 
click on the appropriate letter. The example below indicates that the letter 
F was selected. 

• To search for one particular user, you can type the User ID in the Search 
by ID field and you can press the Go button. 

• If you would like the entire list to be displayed just change the Default 
Value and Behavior Setting called USERJJST_SIZE. This field holds 
the value for the number of users in a selection list before it is broken 
down and grouped by letter, user group or name. 


User Accounts Summary 


Add a new user Select users to display | * All active users 
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L/ser Accounts Summary screen 


2. Click the Add New User icon. The Add New User screen appears. 


Add new user 


User ID 

First name 

Last name 

Password 

Verify Password 

Expire password 
User account 
User Groups 


Email address 

Email Format 


HTML 


Date format ] YYYY-MM-DD hh24:mi >J 


Driildown Report format Quick List |rj 

I . , 


r 


Privacy Groups 


r 

& Enabled <~ Disabled 

f!" Administrator 

V Development Manager 

f~ Engineer 

P Guest 

rT QA Engineers 

r~ QA Manager 

f~ TAC Engineer 

r~ TAC Manager 

T~. ABC Corp. 

f~ Emulator 


Update j Can eel 


Timezorte |(GMT) Greenwich Mean Time London 

Notify on own updates <r Yes f- No 
Job title F 


Company name 
Address 


ExtraView 


City 

State /Province f 

Zip / Post Code f 

Country [~ 

Work phone f 
Home phone 

Cell phone f* 

Fax T 

Pager || 


Add New User screen 


/ 


Enter New User Information: 


User ID 

The name that the new user will use to login to the 
system (required) 

First Name 

User's first name (required) 

\ 1 '9 

Last Name 

User's last name (required) 

Password 

User's password (required) 

Verify Password 

Retype User's password (required) 

User Account 

Enabled User may login 
Disabled User may not login 

User Groups 

A functional team where members have the same 
set of privileges 

Privacy Groups 

• 

Privacy Groups enable certain groups within 
ExtraView to view different specific sets of issues 
without making the issue PUBLIC (all users can 
see it) or PRIVATE (only internal users can see it) 

Email Address 

The email address to which automatic email 

A ■ £ ft 4^ £ 4 atffc ft A Jill $W 

notification win be sent 

Email Format 

HTML, Plain Text (brief), or Plain Text (full). The 
oner option proviues jusi a iew iieias, enougn 10 

recognize the issue 

Date Format 

Date format selection applies for the new user 
system-wide 

Time Zone 

Time-zone selection applies for the user 
system-wide 

Notify on own updates 

Enabled will receive automatic email 
Disabled will not receive automatic email 

Company Name 

For internal users, this should reflect the same 
value as COMPANY_NAME in installation setup 

User Profile Fields 

Enter the appropriate user profile and contact 
information 


3. After you have finished entering the information, click the Update button, and you 
will be returned to the User Accounts screen, where you can add another user or 
return to the Administration menu. 

Note: If the application default named ENFORCEJDETAILEDJJSERJNFO is set to 
"Yes", then additional fields will become required. This is used when you want users 
that self-register on the system to provide a significant level of personal details. 


Edit User Accounts 


1 . To edit user accounts, click on User Accounts from the Administration menu 
and the User Accounts Summary screen will appear. 

At the top of the User Accounts Summary screen there is the increased 
functionality to narrow the list of users returned. 

• To return inactive users, all users or users belonging to a particular user 
groups select the appropriate option from the Select users to display 
dropdown. 

• To return all users with a User ID beginning with a particular letter just 
click on the appropriate letter. The example below indicates that the letter 
Fwas selected. 

• To search for one particular user, you can type the User ID in the Search 
by ID field and you can press the Go button. 

Note: The above functionality can be utilized when Editing or Deleting a User 
Account. 


User Accounts Summary 


Add a new user Select users to display |* AJI active users ~ 
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l/ser Accounts Summary Screen 

2. Click the Edit button beside the user account you wish to edit. 
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The user information screen then appears. 

3. When you are done changing the desired information, click Update. 


User ID 
First name 

Last name 

Password 

Verify Password 

Expire password 

User account 
U&er groups 


Change a user's details 


ROBBIE. LLOYD 


Robbie 
|Uoyd 


Privacy Groups 


r 

<? Enabled r Disabled 

Administrator 
r Development Manager 
P? Engineer 
F Guest 
W. QA Engineers 
W QA Manager 
r TAC Engineer 
V TAC Manager 
W ABC Corp. 
r Emulator 

j ; Update I Delete I ; Cancel 


rlloydOsesame.a 

3m 

i 

HTML 

DD-MON-YYYY hh24:mi r] 

Detailed Report^ 


| (GMT -4:00) Atlantic Time(US & Canada) zl 


Notify on own updates Yes f No 
Job title 


Company name ExtraView 

Address |1 23 Main Street 


City jPleasantville 


USA 


State / Province IL 
Zip /Post Code |l2345 

Country 
Work telephone jj 
Home telephone 
Ceil phon? 
Fax 


Change User Details 


Delete User Accounts 


1 . To delete user accounts, click on User Accounts from the Administration menu, 
and then click the edit button beside the user account you wish to delete. The 
user information screen then appears. 

2. To disable a user's login access, click the Disable User Account radio button, 
and then click Update. 

3. To completely remove a user from the system, click the Delete button, and then 
click Update: Note that a user can only be removed if he or she no longer has 
any issues associated with their User ID. You may wish to make the user 
inactive if he or she is no longer authorized to use ExtraView, but still has issues 
in the system. 


System Security Keys 


Each field, button and feature within ExtraView is controlled by what is 
known as a System Security Key. From the Grant Security Privileges section 
you are able to manipulate the Read and Write privileges for these keys to 
allow or restrict access to these fields, buttons, and features. 


System Security Object Summary 


Add a new security key 

Security Key Name 

CFjALLOWEDVALUEJTYPE 
C F_ALLO WE D_VALU E S 

= CF_BATCrlCOMM/^DS 3i . 

CF_BUSINESS_RULES 

CF_CATEGORY 

C F_D ATA_0 1 CTI 0 NAR Y 
' CF DEFAULT VALUES^;- 


Title to display on Screens 

Allowed Value Types 
Allowed Value List 
Batch Commands 
Business Rules 
Categories 
Data Dictionary 
Default Values & Behavior Settings 


System Security Keys Summary 


Edit an Existing Security Key 


1 . Click on the System Security Key option on the ExtraView Administration menu. 

2. Click on Edit and change the description or title as needed. 


Add a New Security Key 


1 . To make a new key, click on Add a New Security Key. 

Note: This should rarely, if ever, need to be done, as new security keys are added 
automatically when you create new fields within ExtraView, 

2. Enter a name and a key is created (I). Database names have no spaces, and 
are composed of letters, numbers, and the characters - _, and +. 

3. Title the new key as you wish (II) 

4. Click the Update button (III). 
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security Key 


»«1 


Fixed Database Nam* 


new field 


CuQUispiay on ^crssns 


New Field 


OpSCripti ui ) jThis is *he new field ihoit will be put onto o screen} 


p Update | :: Cancel 



Add a New Security Key screen 


Grant Security Permissions 

Granting Security Permissions controls group member's access to all fields, buttons and 
features in ExtraView. In setting permissions, the System Administrator has the ability to 
make these kinds of items read only, write only, both readable and writable, or else 
invisible. 


Edit Security Privileges 


1 . Click Grant Security Privileges from the Administration menu 


sesame 




ExtraView Administration 


Users & Security 

0 Use* Accounts 
*0 System Security Keys 
Privacy Groups 

Batch Commands 

® Change a Problem '>*vner 
Changs a Prrjjiiom nrtrimfttftr 


' User Groups 

> Manage Connected Users ^ 


® Change a Problem .Assigned To 
& Chance- a Problem Version Qnen 


Administration screen 
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The Grant Security Privileges screen appears. 


Grant Security Privileges 


® Security permissions for adding records 

® Security permissions for editing records and querying 

© Security permissions for administration options 

# Security permissions for accessing screens 

® Security permissions for security access 

© Security permissions for statuses 


Grant Security Privileges screen 

This screen gives you access to all of the System Security Keys. The options are as 
follows: 

• Security permissions for adding records (Add Problem Items) 

• Security permissions for editing records and querying (Edit and Search Screen 
Items) 

• Security permissions for administration options (Administration Options) 

• Security permissions for accessing screens (Screen Access Options) 

• Security permissions for security access (Security Values within the Status Field 
on Both the Add and Edit Screens) 

• Security permissions for statuses (Status Values within the Status Field on Add 
and Edit Screens) 

By clicking on one of the above options, the administrator has the ability to set read and 
write privileges for any function in the entire system. 
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Grant Security Privileges - Adding Records 


Update; Cancel 
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Granf Security Privileges Screen 


Make a Field or Option Read Only 


1 . Identify the column head for the User Group whose privileges you would like to 
change. 

2. Put a check mark in the Read box for that User Group only. 

3. Click the Update button. 

This change will make the field that corresponds to the given security key read only for 
the selected user group. 


Make a Field or Option Write Only 


1 . Identify the cojumn head for the User Group whose privileges you would like to 
change. 


2. Put a check mark in the Write box, for that User Group only. 

3. Click the Update button. 

This change will make the field that corresponds to the given security key writable for the 
selected user group. 


a Field or Option Read and Write for a Particular User Group 


Identify the column head for the User Group whose privileges you would like to 
change. 

Put check marks in both of the boxes, for that User Group only (Read and Write). 
Click the Update button. 


Make a Field Invisible to a Particular User Group 


1 . Identify the column head for the User Group whose privileges you would like to 
change. 

2. Remove the check marks from both of the boxes for that User Group (Read and 
Write). 

3. Click the Update button. 

Company Name Security 

There is an application default in Administration under Installation & Setup that is entitled 
COMPANY_NAME. ExtraView recognizes this as the main company name. Given that 
this is the case, a new user added with a company name that is different than the value 
in the field associated with COMPANY_NAME will not be able to see PRIVATE issues 
submitted by users in your company. This is especially beneficial if you have customers 
using the system, and you only want them to be abl'e to add issues. 
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Add new user 


User ID 

First name 

Last name 

Password 

Verify Password 

Expire password 
User account 
User Groups 


Email address 

Email Format 
Date format 
Drilldown Report format 


HTML 


YYYY-MM-DD hh24:mi ;t 


Privacy Groups 


<^ Enabled C Disabled 

IT Administrator . 

P Development Manager 

P Engineer 

P Guest 

P QA Engineers 

P QA Manager 

P TAC Engineer 

P TAC Manager 

P ABC Corp. 

P Emulator 

Update | Cancel | 


Quick List 

Timezone |(GMT) Greenwich Mean Time London 

Notify on own updates Yes No 
Job title | 
Company name jExtraView 
Address 



c 

City f 

State / Province f 
Zip / Post Code 

Country J 

Work phone f 

Home phone f 

Cell phone \ 

Fax [ 

Pager [f 


Add a New User screen 


If you have users/customers who self-register, they will able to enter your company 
name (COMPANY_NAME), but they will automatically be assigned to the user group 
entered as the DEFAULT JJSERJ3ROUP. The DEFAULT JJSER_GROUP is set in the 
Default Values and Behavior Settings. This group normally has minimal user privileges. 
By being added to this group, the user will only be able to view PUBLIC records until a 
System Administrator re-assigns them to one or more User Groups. 


Manage Connected Users 

This feature gives the System Administrator complete knowledge of who is on the 
system at any time. The System Administrator is also permitted to sign off any inactive 
users who may have forgotten to sign off, in order to let other users access the system, 
system by selecting a user and pressing the Update button. 
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Manage Connected Users 



Currently Connected User 8) 


User Name License Expiry Time 


red ...white ;and blue (K- 13-2001 15:22. 


r 


?&d whhe and blue 04- 18-2001 1 1 :43 


r 


robbieJloyd Robbie Lloyd 19Api-2Q0l 10.34 



Manage Connected Users screen 

This feature may or may not appear, depending on the type of licensing that a user 
possesses. If you have concurrent licensing, you will receive this feature, and you will 
be able to allow only a limited number of persons to access the system. 

Disconnect Inactive Users 

1 . Click Manage Connected Users on the Administration menu. 

2. Click on the checkbox associated with the user(s) whom you want to remove 
from the system (I). 

3. Click the Update button (II). This action will force the selected user sessions to 
expire and open up concurrent license seats. 


Manage Connected Users 


Manage Connected Users screen 

Privacy Groups 

Privacy Groups are a feature that allows the System Administrator to divide information 
and data in the system so that select users can be excluded from access to certain 
problems (something that the PRIVATE designation does not provide). Also, this 
functionality differs from controlling access through read and write Security Privileges by 


The following users are currently signed on to ExtraView. Please check the users 
installation is licensed for 10 users. 



r 


robbie .lloyd Robbie Lloyd 19-Apr-2001 10:34 
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virtue of the fact that Privacy Groups do not control access by limiting field-level views of 
data records, but rather limit access to the data record itself. 


PR1VACY_GR0UP 


IB 

I 

Add a now privacy group 

Privacy Group Name Title To Display On Afl Screens 

TEST " • . ' / Tesi ' ; - •' T'" 

2 recoids ieieeied 


Privacy Groups > 

For example, if I belong to the Test Privacy Group, then anyone in that privacy group 
can see my problems, but no one outside the privacy group can do so (unless the value 
in COMPANY_NAME is the same as the host company name). Additionally, as a 
member of the Test Privacy Group only, I cannot see any problems that have been 
submitted by members of the XYZ Privacy Group. The only users that are allowed 
access to these issues are the members of the host company that have the 
COMPANYJMAME value, and any other user whom belongs to the XYZ Privacy Group. 
Finally, if the problem is made PUBLIC instead of PRIVATE, then everyone who uses 
the system can see the record, regardless of the Privacy Group to which they belong. 


Add a Privacy Group 


1 . Click on Privacy Groups under Users & Security on the Administration menu. 


1 U ■ -1 - • J. !■ | 

ExtraView Administration 

Users & Security 

i 

( 

<£> User Accounts 

® User Groups 

& System Security K*yS/L 

© GfSri! Security Privilege 


Manage Connected User* 

Batch Commands 


4> Change a pjobiem Owner 

® Change a Piobiem Assigned To 

Change a Problem Original or 

$ Change a Problem Vision Open 

d Change a Problem Module 

0 Change a Problem Module Oswer 


Administration menu 


The Privacy Group screen appears. 
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2. Click on the Add button. 
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PRIVACY GROUP 




And 3 n&w privacy group 

Privacy Group Name 

TEST. : i : ' . 
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Privacy Group screen 


The Add A Privacy Group screen appears. 
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Add a privacy group 
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S Updated j j:: Cancel: | 
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Add Privacy Group screen 



3. Type in the name of your new Privacy Group that is relevant to the group name 
as a title (I). Database names have no spaces, and are composed of letters, 
numbers, and the characters and +. 

4. Type in a title name (II). 

5. Click the Update button (III). 

The System Administrator may add users to Privacy Groups by clicking the checkbox 
beside the desired Privacy Group name on the Add New user screen, or the Update 
User Details screen under User Accounts on the Administration menu. 


'uvacy b roups p group xyz 
r Test 


Update 


Cancel 


norns prions j 
Cell phone 


Pa* 

! CI -\ 


Add new user screen 
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BUSINESS RULES & WORKFLOW 


In addition to user and security management, ExtraView allows the System 
Administrator to manage workflow by creating and enforcing state change rules and 
business rules. 

■ 

* 

Creating State Change Rules 

State Change Rules allow the System Administrator to control the process by which the 
statuses of issues can be altered. To conform to your company's workflow, ExtraView 
can create State Change Rules based on three different workflow formats: 

I. Default Format: All users must follow the same rules for all different 
product, projects, categories, modules etc. 

II. User Group Format: Different state change rules apply to different 
user groups within your company. 

III. Product Format: Certain products can be changed to statuses that 
are different from those that apply to other products. 


Create State Change Rules 


1 . From the Administration menu, click on Default Values & Behavior Settings. 

2. Click the Edit button next to the default value entitled 
ENFORCE_STATE_CHANGE_RULES. 

3. Change the value from "No" to "Yes," and click the Update button (if the value is 
already "Yes" then leave it so). 

Note: For the next step, you will have to decide which workflow is best for your 
company. You are able to choose between DEFAULT, PRODUCT and 
USERGROUP (as discussed above). The most common choices are DEFAULT 
and USERGROUP. PRODUCT will only be used if you want to restrict certain 
products from being set to certain statuses. 

4. From Default Values & Behavior Settings, click the Edit button next to the 
S E P A RAT E_WO R K_F LOW default value. 

5. Change the value to DEFAULT, USERGROUP or PRODUCT and press the 
Update button. 
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Customize State Change Rules 


From the Administration menu, under Business Rules & Workflow, click on State 
Change Rules. 


Business Rules & Workflow 


State Change Rule 


Based on your choice of workflow format, one of the following three screens will 
appear (the screens may look slightly different than what is represented here, but the 
functionality is identical). 


State Change Rules 


Check the boxes of the allowable state changes you want to allow users to make. Remember that all the rules can be switched off or on together 
in the Default Values & Behavior Settings screen. 


Update : Cancel 



Closed 

I 

• Fixed 

To Status 

Open 

Pending 

Unassigned 

Closed; 

j „™ 

9 

1 r 

9 


From Fixed! 9 

.... . p 


r | 

Open! 

. r 

. 9 . \ 

r • 1 r ; "~ . 

Pending] 

9 

9 



r, 

Unassigned; 

i 

r 

r 

9 

• • r ' ; '*\ 



Fig. 1-State Change screen based on selection of DEFAULT 


State Change Rules 


Check the boxes of the allowable state changes you want to allow users to make. Remember that all the rules can be switched off or on together 
in the Default Values & Behavior Settings screen. 


Select User Group J Administrator 
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Update | Cancel | 


Fig.2-State Change Rules screen based on selection of USERGROUP 
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State Change Rules 


Check the boxes of the allowable state changes you want to allow users to make. Remember that all the rules can be switched off or on together 
in the Default Values & Behavior Settings screen. 


Select Product jDevTest ~~ jj 


From 
Status 


To Status* 
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Fig.3-State Change Rules screen based on selection of PRODUCT 
Enforce State Change Rules 


1. For PRODUCT or USERGROUP workflows, select a PRODUCT or 
USERGROUP from the dropdown list (there is no need to perform these steps 
for DEFAULT). 

2. Start by clicking the check boxes for each From Status (left-hand side) to the To 
Status (right-hand side). 

a. Fig. 1 shows a scenario where a user is able to change the status of an 
issue from Fixed to Closed, but not from Open to Closed. 


b. Fig. 2 shows a scenario where an Administrator is able to change the 
status of an issue from Fixed, Open, and Pending to Closed, but not from 
Unassigned to Closed. 

c. Fig. 3 shows a scenario where the product DEV TEST can be changed 
only to a status of Closed, and nothing else. This may indicate that the 
particular company is no longer developing the product DEV TEST. 

3. After you are satisfied with the From and To values, click the Update button. 
Select another Product or User Group from the list, and follow steps 1 & 2. Do 
this for each Product or User Group. 

After your final update, your State Change Rules are fully implemented. You can 
now test out the functionality by editing an issue and trying to change the From 
Status to a To Status that you did not specify. 

Customize Business Rules 


ExtraView has the ability to apply business rules based on your particular business 
processes. Customized Business Rules can include: forcing users to add Release 
Notes when they close an issue; making sure that Comments are added when a 


disposition is Fixed] almost anything else you can imagine. The screenshot below is an 
example of a Customized Business Rule. 


Rule 2 

This business rule is applied when updating problems only. If you check a disposition then new comments must be added whenever the 
disposition changes to the values displayed below: 


r 

Cannot Duplicate 


Deferred 


Duplicate 


Fixed 


Invalid 


Need more info 


None 


Not a bug 


User error 


Update Cancel 


Sample Customized Business Rule Implementation screen 

Issuing Batch Commands 

* 

A Batch Command is an ExtraView feature that allows you to edit any number of records 
in only a few small steps. Listed below are the standard Batch Commands, although 
your system may have different Batch Commands or alternative versions of the existing 
ones. 


Batch Commands 


® Change a Problem Originator 

© Change a Problem Owner 

® Change a Problem Version Open 

© Change a Problem Module 

® Change a Problem Component 



Batch Command Screen 


Issue Batch Commands 

We will use Owner for purposes of example, but all batch commands will work in a 
comparable manner. 

1 . From the Administration menu, click on Change a Problem Owner. 
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A screen similar to the one below appears. 


Change the Problem Owner 


This command will re-assign all the problems that are currently owned by the person in the first list box, and will change the ownership to the person in the 
second list box. Only problems with the states selected will be processed. Note that you can only change the ownership to a person who has an activated 
account. 


Current Owner f 
Changa to f 


7 


*i«u* f7 N 0ne 


f? Closed 

I? Fixed 

F Open 

F? Pending 

17 Unassigned 


Execute ; Cancel 


Change Problem Owner Batch Command Screen 


2. Select the Current Owner from the dropdown list box, or in this case, from the 
pop up text box. This is the name of the person whom you no longer want to be 
associated with the issues. 



3. Select the New Owner from the dropdown list box, or in this case from the pop 
up text box. This is the person who will be the new Owner of the issues. 



4. Decide which statuses you would like transfer to the new Owner, and then check 
the appropriate boxes. 


otatus 


F None 

W Closed 

W Fixed 

P Open 

P Pending 

P Unassigned 


Execute Cancel 
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Click the Execute button after your statuses have been selected. 

The changes may affect a large number of records in your database; the screen 
below gives you a final opportunity to cancel or to continue with the change. 

Change the Problem Owner 

If you go ahead and execute this command, the ownership of 6 problems will be reassigned from robbie.lloyd to rob.lloyd. 
You will not be able to undo this change. Press the Execute button to continue, or the Cancel button to quit. 

Execute | Cancel | 

Batch Command Confirmation Screen 

Click the Execute button to proceed with the batch change. Click Cancel if you 
do not want to follow through with these modifications. 
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EMAIL FEATURES 


> 

ExtraView offers a number of email features that designed to facilitate 
maximum flexibility in managing inter-group, cross-functional, and business- 
to-customer communication. At the highest level, this section will be divided 
into the following three heads: Email Notification, Email Generation, and 
Interest Lists. 


As a general default, ExtraView automatically sends email to the person who 
Originated an issue, the person who is Assigned to the issue, and the person 
who is selected as the Owner of the issue. Listed below are the email 
functions that may be defined by the Administrator and the user. The main 
email functions include: 


Administrator-Defined Features 

• Turn System-Wide Email On or Off 

• Disable Email Generation for User Groups 

• Enable or Disable Email to External Users 

• Assign Module Owner 

• Set Product Email Address 

• Customize Email Subject Line 

• Show Recipients at Bottom of Email 

User-Defined Features 

• Notify of Own Updates 

• Select Email Format 

• Disable Automatic Email Generation 

• CC Email 


Turning System-Wide Email On or Off 

1 . From Administration menu, click on Default Values and Behavior Settings. 

2. Scroll down until you see EMAIL_NOTIFICATION. 
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3. Click Edit and change the value to "Yes", in order to turn on Email Notification, 
or set the value to "No" to turn off Email Notification system-wide. 

4. Click the Update button. 

Disable Automatic Email Generation for User Groups 


The System Administrator may turn off the Generate Email field for particular User 
Groups, so that users belonging to these groups will not have the option to disable 
automatic email generation. 

1 . From the Administration menu, click on Grant Security Privileges. 

The following screen will appear: 


Grant Security Privileges 

H Security permissions for adding records 

® Security permissions for editing records a 

® Security permissions for administration options 

® Security permissions for accessing screens 

® Security permissions for security access 

@ Security permissions for statuses 

Grant Security Privileges Screen 

2. To turn the Generate Email field option off for the Add Problem screen, click 
Security Privileges for Adding Records. 

3. To turn the Generate Email option off for the Edit Problem screen, click Security 
Permissions for Editing Records and Querying. 

4. Scroll down until you see PR_ADD_PROBLEM.EMAIL_SWITCH (this is for the 
Add screen) and PR_RESOLUTION.EMAIL_SWITCH (this is for the Edit 
screen). 

To turn this field off for a specific User Group, uncheck the Read and Write boxes (for 
that group only) and click the Update button at the bottom of the screen. 



74 


Disable Include Guests for Screens or User Groups 


1 . From the Administration menu, click on Default Values and Behavior 
Settings. 

2. Verify that IGNORE_USER_GROUP is equal to the user group you are 
using for external users. This is normally Guest or Customer. 

3. If you make a change, be sure to click the Update button. 

4. From the Administration menu, click on the option that says Grant 
Security Privileges. 

5. To turn the External Email option off for the Add Problem screen, click 
Security Permissions for Adding Records. 

6. To turn the External Email option off for the Edit Problem screen, click 
Security Permissions for Editing Records and Querying. 


Grant Security Privileges 



Security permissions for adding records 


Security permissions for editing records and querying 
Security permissions for administration options 
Security permissions for accessing screens 
Security permissions for security access 
Security permissions for statuses 



Grant Security Privileges Screen 

7. Scroll down until you see PR_ADDJ D ROBLEM.EMAIL_CUSTOMER (this 
is for the Add screen) and PR_RESOLUTION.EMAIL_CUSTOMER (this 
is for the Edit screen). 


Customer Email 

Sned Email to Customer 

PR ADD PROBLEM. EMAIL CUSTOMER 


Read (Write 


e ad [Write ] (Read [Write 


F JF I IF F 


Re ad (Write 


Security Privileges for Emailing External Users 
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8. To turn this field on or off for a specific user group, check or uncheck the 
appropriate Read and Write boxes (for that group only) and click the 
Update button at the bottom of the screen. 


Assign Module Owners 

The System Administrator may assign Module Owners, such that state changes to given 
modules produce automatic email notification for designated owners. 

1 . From the Administration menu, click Module Names. 

2. Locate the Module to which you would like to assign an Owner, and click the 
associated Edit button. 

3. Scroll through the list of available users or else select the owner from the pop up 
text box. 

4. Click the Update button. 


Set Product Email Address 


The System Administrator may set an email address for specific products, so that 
ExtraView users associated with that product will receive automatic email notification 
about product-related issues. 


Customize Email Subject Line 


ExtraView gives the System Administrator the ability to customize the subject line of 
incoming emails. 

1 . From the Administration menu, click on Default Values and Behavior Settings. 

2. Scroll down until you see EMAIL_SUBJECT_TEMPLATE and click the 
associated Edit button. 

3. Type in the names of the fields you would like to display. Your custom email 
subject line can include any field from your ExtraView installation. These values 
are generated dynamically, based on the particular issue. 


4. If you would like values in your email subject line you must surround them with 
"$$". Normal static values can be typed in. See the example below: 


Sample Text 

Subject Line Output 

$$ID$$ - $$SHORT DESC$$ 

12345 - Problem with List Entries 

$$ASSIGNED T0$$ 

($$PRODUCT NAME$$; 

$$MODULE NAME$$) - This is an Email 

Rlloyd (Product X; Module Y) - This is an 
Email 

Issue # $$ID$$ This is Assigned to 
$$ASSIGNED T0$$ 

Issue # 12345 This is Assigned to Rlloyd 


Notify of Own Updates 


This feature gives you the option to disable automatic email to yourself on issues that 
you Add or Edit. 

1 . From the Administration menu click on the User Accounts option 

2. Click the Edit button next to your User ID. A screen similar to the one below will 
appear. 


Change a user's details 


User ID ROBBIE. LLOYD 
First name [Robbie 


Email address jrlloydg sesame. cow 


Last name [Lloyd 
Password 


******** 


Email fotmat |»tml 
Date format j dd-mon-yyyy nh24mi 


Ve '%|******** 


Mdown Kepoit | Detalled Rep0ft 


Password 

Eypka password p 

Item account <♦ Enabled C Disabled 
' User groups 17 Administrator 

n HowQlnnrnQnt. Mananar 


formal 

Time-ZOne |(OMT -4:00)Ailantie Time(US& Canada) 

Notify on own 


"3 


updates 


Yes C. No 


Job title j 


Change a User's Details screen 

Note: Users can also turn this feature "On" or "Off" by clicking on Click to edit your 
personal options, from their ExtraView Home Pages. 



3. If you do not want to receive email notification each time you update an issue, set 
the value in Notify of own updates to "No". 


Notify on own ^ ^ ^ M 
* j Yes * No 


4. Click the Update button. 
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1 


Select 


il Format 


Choose to display incoming email in one of three formats: HTML, Plain Text (full) and 
Plain Text (brief). Plain Text (full) displays the entire email, while Plain Text (brief) 
shows just a few lines, so that the issue may be recognized. 

1 . From the Administration menu, click on the User Accounts option 

2. Click the Edit button next to your User ID. 


A screen similar to the one below appears. 


Change a user's details 


. Useife ROBBIE. LLOYD 
Rrst name (Robbie 

Last name |Lioyd 


Password j******** 
Veril 


ft 


******** 


Password 

Expire password p 

User account <• Enabled <~ Disabled 
User groups F Administrator 

r* ,. DovolonmQQt-Maixaaflj: 


Email address 

Email format 

Date format 

Dillldown Report 
format 

Timer on* 

Notify on own 

Job title 


rlloydGsesame . com 


HTML 


DD-MON-YYYY hh24:mi 


Detailed Report 


(GMT -4-00) Atlantic TimefUS & Canada) 

Yes C No 


Change User Details screen 

Note: Users can also turn this feature "On" or "Off" by clicking on Click to edit your 
personal options from their Extra View Home Pages. 



3. The default email format is HTML. If you would like to see your email 

notifications in another format, select the desired format from the Email format 
list. 


j> Email format 

HTML 


Date format 

IHTML ! 

Plain text (full) 


Drill rlnwn Resort 

Plain text (brief) 



Email Format Option 
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Below are examples of the different email formats: 


Subject DEV - 12231 
Date: Fn. 15 Jun 2001 16:53:09 -0700 (PDT) 
From: "EstraYiew" <■ extr aview. 'aa@8esame.com> 
To: "Robbie Llo ^ d" <f )l o ycl@sesanie. com> 


mm 

■■ ■ ■: ■■■■■ , • • :•• 

; : 

• ■ ."■ > 

': - . : • 


12231 

test 

: 

;. : ;.:.;...:.„.;;.; 

J-:-, 

„:.„:;.-—.:«;....:.: ; 

■ i ' : ' " ..• 





08-WAR.2OO1 

15-JUN-20O1 16:51 



jkiitiKtai' r» . 


S'" v ; v —:—r j 



tot- 1t«yd 



ft 09. LLOYD 

B.s*«rV> =;.; .. ; 

y . ■ . :. ■■ . 

ffi«i^: ;;, ■ . ". , : "i r&g 

.... . m ■ . ■ 











:■■ ■ ■. 

■ ■■ ■.. ■'. ■. .. '■ 


PM 







?■ 

! :■'! ! •• 



800 TOM 






."• -r™™ 



■ " ,?'*■ ■' . . :. 

, ■•.—«■• 







?wt«; "' : : ; 


" : 

• 

1 

cios*d 





: -v-vr;-;-- ; :-»;:: 


............ 


cc: Medina, fob Hoyd. Rgbbi^ Ugyrj. 


HTML Email 


Subject : Open [#19419] : Category doesn't seen tied to Product anymore 

Date: Wed. 2 May 20O1 13:57:53 —0 700 (PDT) 

From: "ExtraVinif" < 8xtrawiov-user(Pcusto»er . co«i > 

To: <eupport •sosawo . com > 


ExtraView Notification for Bug 9 19419 

"Synopsis: Category doesn't booh tied to Product anymore 

Link : http : //www . extraviov . not/extrawi8wsql/SE_Signon . FraneSa t 7 p_ca« 


;o_id-19419 


•Product. : Dov Tools 
•Originator: rlloyd 
•Owner: rlloyd 
•Changed By : dwong 
• Prion ty : 1 

Severi ty : 
•View : Private 

•Last Modified: D2-MAY-2 0 01 13:57 
•Category : Sof t ware 
Alt ID: 

Created: 02-MAY-01 

•Module : ExtraViev 

Component : 
•Platform: all 

OS: . * 

Clarify ID: 

Test Case ID: 

Test Case Location: 

Problem Reproducible in SQA : 


•Version Open : 
•Status: Open 
Version Closed 
Disposition : 


3.1.2.1 


•Description : 

If you select Product «EV, Ca tegory -Sof t ware . you will 
"EV " Go into Admin. . .Modules and one is Hardware. 


>e two module 
is Sof tware 


called 


Comment i 


ExtraViev — Copyright Sesame Technology 1999. 20O0 . All rights 


Plain Text (Full) 


Subject: Open [#19419]: Category doesn't seen tied to Product anymore 

Date: Wed. 2 May 2001 13: 57: S3 -0700 (PDT) 

From : " Ex t raV iev" < ex t ra v i e w-user@cus t omer . com > 

To : < support ©sesame . com> 


ExtraViev Notification for Bug # 19419 

•Synopsis: Category doesn't seem tied to Product anymore 

Link : http: //www . extraview . net/"extraviewsql/SE_Signon. FrameSet?p_case_id a 19419 

•Product : Dev Tools 
•Originator: rlloyd 
•Owner: rlloyd 
•Priority: 1 
Severity : 


ExtraViev - Copyright Sesame Technology 1999, 2000. All rights reserved. 


Plain Text (Brief) 


Disable Automatic Email Generation 


Each time a user Adds or Edits an issue, he or she has the opportunity to halt all email 
generation by un-checking the Generate Email checkbox at the bottom of the Add and 
Edit screens. 


Attachment: 


Br 


Description 


File Name 



F Generate Email 


include external users 


CC Email j 


Update 


Delete Interest List 


Return 


Email Portion of Edit Screen 


Note: the Edit screen can be accessed by drilling down on your Home Screen folder, 
from the Add Problem Summary Screen, from email notification, as well as from 
various reports. 


Disable Generate Email to External Users 


Situations often arise where a customer may need to enter an issue, but you may not 
want the customer to see all of the different state changes that the problem issue goes 
through. When you Add or Update an issue, you have the option of halting email to 
external users. 
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1 . At the bottom of the Add and Edit screen you will see something similar to the 
screenshot below. The default setting is not to send email to external users. 


I? Generate Email r 

CC Email I 

I Include Guests 


2. If you would like your external users to receive an email, click the Include 
Guests check box and continue to update the issue. 


Enable CC Email 


This feature gives users the opportunity to send a one-time email to people who are not 
directly associated with a particular issue. 

1 . To utilize the CC Email functionality, type email addresses (separated by 
commas or semi colons) into the CC Email field prior to updating the issue. 


rob@sesame.com, joe@hotmail.com, robyn@aol.com| 


CC Email Field 


Email Interest Lists 

ExtraView allows users to subscribe to interest lists for nearly any field in the system. 
An Interest list allows users to receive emails about particular Metadata in the system. 
For example, you may want to notify a certain user each time an issue goes to a * 
Severity of Critical or a Status of Open. Interest lists can be created for Products, 
Modules, Statuses, Priorities, Resolutions, Severities and User Defined Fields. 

The first example below will illustrate the addition and management of interest list 
members for normal Configuration items (Product, Module, Priority etc.). The second 
example will be illustrative for User Defined Fields (fields specific to your installation). 


Create Normal Configuration Item Interest Lists 

Normal Configuration items include items such as Product, Module and Priority. For this 
example, we will use Product (PRODUCT_NAME;; adding Interest List members for the 
other configuration items will be the same. 
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1 . From the Administration menu, click Data Dictionary under Installation & Setup. 

2. Scroll down until you see Product (PRODUCT_NAME), and click the Edit button 
next to this value. 


3. Scroll down until you see the following: 


c 



Option to Enable Interest Lists 

4. Check the Yes radio button. 

5. Click the Update button at the bottom of the screen. 

6. Click Administration and scroll down to near the bottom of the page. 

7. Click on Products. 

8. Locate the Product or Products to which you would like to add Interest List 
members, and click the associated Edit button. 

The following screen will appear: 


Change Product details 


Fixed database name NETTRANSAOTIONS 

Title 10 display On SCieenS |f*et Transactions 


E-Mail Address | 

Active Yes r no 

Update | Delete ; 1 ; ; Cancel ! 


Product Interest- Lis! " 


Change Product Details Page 


9. Click the Product Interest List button. 


10. Click the Add a new member to the Interest List button and the following 
screen will appear: 
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Add a new member to the interest list for Tech Pubs 


Select the user to add to the interest list 


Update;;; ;; Cancel 



Add a New Member to Product Interest List screen 

1 1 . From the screen above, you can select the member of your organization you 
would like to add to the Tech Pubs (product for this example) interest list by 
selecting the question mark. A screen like the one below will appear, in which 
users can be chosen alphabetically, by user ID, First Name, or Last Name. 



j^mmi. '^--m 

:^CiiCH ;o;va it?tt«>i to r*tii*v9 us*is whose- 
I userl- idsb^'q'ins : with that i&rivt or < lick • • 

^^3^v%CSP *"^* ' fiffiftft*'-, *<'&"'■■''''' i ' ' " '' : : : < : : : : : : : : :: : : : : : : : : : : i : : : : : : : : : : : : : : ; : ; : ! :': ; : "" : .' ''' : -:-: ; r'r ; :':': ; :' : -: : !\ : :-- >: - 

t h ef&tof return^ 


Or client o-'s-s feet bv 

j^ u x^,4t/.- .. . - 


: -S>"":. i 

' - 


. - AS CD E FOH 


L M 


r : ?5f : SS*8 


Choose i uset irorri I the Isst-or click jvlar 


12. Continue to add users as desired by repeating step 1 1 . 


Create User-Defined Field Interest Lists 


j 


All Interest List members will be automatically sent email each time this product is 
involved with a problem issue. The same process can be used for Products, Modules, 
Statuses, Priorities, Resolutions, and Severities. 

For this example, we will use the User-Defined Field Platform. To add members to UDF 
Interest Lists: 


1. From Administration menu, click Data Dictionary. 


83 


2. 


Scroll down until you see the PLATFORM UDF. 


3. 


Click the associated Edit button. 


4. 


Scroll down until you see the following: 


Enable interest list on this 

field 


& Yes 


No 


Option to Enable Interest Lists 

5. Check the Yes radio button. 

6. Click the Update button at the bottom of the screen. 

7. From the Administration menu, click on User Defined Fields. 

8. Click the List button next to Platform. 

9. Click the Edit button next to the particular Platform to which you want to add 
interest list members. 

10. Click the Add a new member to the Interest List button. 
The following. screen will appear: 

Add a new member to the interest fist for 1000 


Add a new member to the UDF Interest List screen 

1 1 . Select the member of your organization whom you would like to add to the 1000 
Platform Interest List. 

12. Continue to add users to the 1000 Interest List as desired by repeating step 11. 
The same process can be used for any other list UDFs in your system. 


Select the user to add to the interest list 



Update Cancel 
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■ 


Edit Personal Email Interest Lists 

i 


A Personal Interest List can be maintained to allow someone other than the owner of a 
problem to track its progress. When a problem is placed on a Personal Interest List, the 
user will automatically receive an email each time a change is made to a problem in the 
database. 


Emails are automatically generated to the owner of the problem and the assigned 
person of the new problem entered. If you are changing the state or other information 
related to a problem, then email is sent to the owner, the originator and the person 
assigned to the issue. If any of these values are the same, only one email will be 
generated per person. In addition, users can subscribe to an interest list for any problem 

1 . Click the Interest List button at the bottom of any given Edit screen. 

2. Click the Add a new member to the interest list button to add a person to the 
interest list. 

3. Select the name of the user from the list that is presented. 

4. Click the Update button. 

* r 

You can edit your inclusion on an interest list if you belong to one, but this does 
not apply to Product, Module or other specific field lists. 


Remove User ID from Interest List 

1 . From your user Home Page, press the Click to edit your personal email 
interest list button. 


Problem*: you originated: 


■.'resigned. 


Count 

" 3.. ' : 


PC 


Pi 


P2 

1: 


U*je this quick search for simple queries. For rT.ore comple* searching use the Search/Report menu button. 


Sftstus | '.Any* T| 


Assignee To 


Piksrily j * Any * ^1 
Owner 


Product |* Any* >] 


Cat frgc>;$ j ".Any* ■ 
Module |* Any* jj 

Version Ojsen 


From Dsts 


To Date 


<*" Priority 
Bug ID 
<~ Date Modified 


Da=e vffestod [~ 
Ls?;? Modified j 


Ascending 
<~ Descending 

Record* per Page fio F] 


uihoi 


earcri 


Click to. change your current user role. 
Click to edit your persona! options. 
^ Chck to edit you: per<:onoi eroof! mje-esi Hi! 



Home Page screen 
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2. Click the Edit icon beside the issue number from which you want to remove yourself. 


Email Interest List for Darrin 

Wong 


If you wot 

ild iik 

& to bo added to or d&iotf 

2fi jfOfTi Dth&r interest jistS, ptfeSSf? t 

cmaci youi system administrator. 



Bug# Status 

T/f/e 




12335.. Un assigned 

Teei fof sistfc change. rule? 





IsVi't] 


12356 Un assigned 

c alendar 




:ot<h tstfl&cte-d 






! lii!i^H 




Personal E-mail Interest List screen 

2. Click the Delete button and you will be removed from the interest list. 


Delete an interest list entry for dwong 


Delete interest hst entry for Bug it 1 251 8 

Status Unassigned 
Title This is a problem 


: Delete | Cancel 


Delete Interest List Entry screen 


ExtraView Help 


The ExtraView application includes a comprehensive HTML-based help system that you 
can access at any time by clicking the Help button on the navigator frame. In addition, 
many tool tips and context-sensitive links are defined throughout the application. 

When you place the mouse cursor over a screen label that has a tool tip, a small window 
will appear next to your mouse cursor with a definition of what this label does. These 
labels allow you to define help tips for your users. If you press the mouse button over a 
label, you will be taken to a specific page within the help system. If you do not have a 
specific page defined within the screen name Administrative section, you will be taken to 
the Help Index page. This page consists of links to detailed information about the 
system. 
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ExtraView Help index 


iThis is the main Help Index for the ExtraView problem tracking and resolution system. From here you can navigate to any help topic. Help windows may be left open at all 
[times that you are working on problem reports within ExtraView. 


Help Topic List 

• Before You Get Started 

• Adding a New Problem 

• Editing an E:3sting Problem 

• Search/Report 

o Reporting & Searching Capabilities 
o Searcteng the Problem Database 

• Security 

o Create and Maintain User Accounts 
o System Security Keys 
o User Groups 

o Grant Security Privileges to User Groups 

o Allowing TJser Groups to see only certain Statuses 

• Re vi ewing Problem History 

• Administration 

o Allowed Values 
o Batch Commands 
o Categories: 

o Changing Personal Details 
o Data Dictionary 

o Default Values & Behavior Settings 

o Enclosure Types 

o Installation Setup 

o Module Names 

o Module Types 

o Priorities 


ExtraView Help screen 


/2£F: frl B*fT' 

MP. 




From eternity to 16 seconds.txt £*l/f4/^?/ , — A—/ 
From: Rick Banister [rick@sesame.com] )LY\\C?( { If 

Sent: Wednesday, May 08, 2002 4:32 PM 

To: Tom Strzemieczny ; Maria Scharin; Carl Koppel ; Michael stebbins; O Li P~ /?A/ r v 

Steve Hoydic 67 ^ / 

Cc : dev@sesame . com 

Subject: From eternity to 16 seconds 

I've got the worse case query so far down to 14 second, which is to query on 5 
problem fields, 1 udf, and sort by a UDF. The EXPLAIN PLAN shows rediculously high 
cost, but the actual performance is very good, even with the SGA cache cleared by 
restarting the database. 

There are two items, a DDL change to bring the values into the index for an 
index-only search, and changing the query to use FlRST_ROWS so it doesn't try a full 
index query of the PROBLEM_UDF table: 

DROP INDEX IX_PROBLEM_UDFl; 
CREATE INDEX IX_PROBLEM_UDFl 

ON PROBLEM_UDF (problem_id, udf_id, VALUE, VALUE_NUMBER , VALUE_DATE, UDF_LIST_ID 

) 

TABLESPACE EXTRAVIEW_IDX; 
ANALYZE INDEX IX_PROBLEM_UDFl ESTIMATE STATISTICS SAMPLE 20 PERCENT; ANALYZE table 
PROBLEM_UDF ESTIMATE STATISTICS SAMPLE 20 PERCENT; 

select /*+ ORDERED first_rows 

INDEX (PROBLEMl IX_PROBLEM5) 
INDEX(PROBLEM2 IX_PROBLEM6) 
INDEX(PROBLEM3 IX_PROBLEM7) 
INDEX(PROBLEM4 IX.PROBLEM8) 
INDEX(PROBLEM5 IX_PROBLEM2) 

index (pudf ix_problem_udfl) 

*/ PROBLEMl. ID 

from PROBLEM PROBLEMl, PROBLEM PROBLEM2 , PROBLEM PROBLEM3 , PROBLEM 

PROBLEM4 , PROBLEM problems; problem_udf pudf, udfjist where PROBLEMl. PRIORITY in 

('PRIORITY 2') and PROBLEM2 . SEVERITY_LEVEL in ('MAJOR 1 ) and PROBLEM3 . STATUS in 
('OPEN') and PROBLEM4. PRODUCT_NAME in ('EVJAVA') and PROBLEMS. ASSIGNED_TO in 
( ' AIMEN '• ) and PROBLEM2 . ID = PROBLEMl. ID and PROBLEM3 . ID = PROBLEM2 . ID and 

PROBLEM4. ID = PR0BLEM3 . ID and PROBLEMS. ID = PROBLEM4. ID and pudf . probl em_i d(+) = 
problem5.id and nvl (pudf . udf_id(+) ,88) = 88 and udf^list . udf_list_id(+) = 
pudf . udf _list_id and exists 
(select 1 

from probl em_udf udfl 

where udfl. probl em_id = PROBLEM5 . i d 

and udfl. udf __id = 88 

and udfl.udf_list_id = 6231) 

ORDER BY udf_li St. title DESC 


Page 1 


(a/ 7£ 7 f Oo 



mo betta SQL statement.txt 

From: robert lange [rlange@sesame.com] /^/|f"//^Y7" Crf 

Sent: Thursday, October 10, 2002 11:59 AM C * 1 i f 

To: Dev@sesame. Com * 
Cc: LeeAnn Pultz; Maria Scharin QN fcr f ft 

Subject: mo betta SQL statement 

I ran into some surprising results tuning a query that I want to pass on to anyone 
writing SQL -- at least for the Oracle platform. The change involved replacing two 
joins in the where clause with "pseudo tables" in the where clause. The first 
change decreased resources by a factor of 10,000 in the explain plan, but the 
resulting query still took 37 What was especially surprising is that in the final 
change, even tnouqh the explain plan didn't show significant difference, the 
execution speed changed dramatically: by a factor of 40 again. 

the basic query involved reporting, where you have a list of ids, and the problem 
udf table, the first pass on the query looked like this (simplified for clarity): 

select p. id, p2.id 

from problem p, problem p2, problem_udf pu, udf u where p. id in (?,?,?,?,?,?,?,?) 

and pu.udf_id = u.udf_id and u.name = '?' 

and p2.id in (select problem_id from problem_udf 

where udf_id = u.udf_id and u. value = p. id) ; 

the key was to rewrite the code to put some of the where clause into the from 
clause, step 1 was: 
select p. id, p2.id 

from (select id from problem where id in (?,?,?,?,?,?,?,?)) p, 

problem p2, problem_udf pu, udf u 
where p. id in (?,?,?,?,?,?,?,?) 
and pu.udf_id = u.udf_id and u.name = '?' 
and p2.id in (select problem_id from problem_udf 

where udf_id = u.udf_id and u. value = p. id) ; 

this reduced resources per the explain plan by a factor of 10,000 or so, but the 
query still took 40 seconds to run for 5 ids. the second step was to apply the same 
strategy to eliminate the joins on the udf table: 

select p. id, p2.id 

from (select id from problem where id in (?,?,?,?,?,?,?,?)) p, 
problem p2, 

(select problem_id, value from udf, problem_udf 
where udf. name = ? and problem_udf . udf_id = udf.udf_id) pu where pu. value = 
p. id and p2.id = pu. problem_id ; 

this version did not look different in the explain plan, but the execution time 
dropped to under a second. 

I'm not sure that this is always more efficient, and it may have to do with the fact 
that the actual query was quite a bit more complex, but the approach clealy can have 
dramatic results. 

enjoy, 

robert 
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